설명서Commerce클라우드 인프라의 Commerce 안내서

CLI를 사용하여 분기 관리

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • 개발자

magento-cloud CLI를 설치하려면 Cloud CLI 참조를 참조하십시오. magento-cloud CLI를 설치하고 클라우드 인프라에 대한 원격 액세스를 위해 SSH 키를 설정한 후에는 magento-cloud CLI 명령을 사용하여 프로젝트의 환경을 관리할 수 있습니다. 환경 아키텍처에 대한 자세한 내용은 Starter 아키텍처 또는 Pro 아키텍처를 참조하십시오.

Cloud Console을(를) 사용하여 분기 및 환경을 관리하려면 을(를) 사용하여 분기 관리 Cloud Console를 참조하십시오.

CLI 명령 사용

magento-cloud CLI 명령은 Git 명령과 유사합니다. 이를 사용하여 프로젝트에 연결하고 환경을 관리할 수 있습니다. 모든 디렉터리에서 명령을 실행할 수 있지만 프로젝트 디렉터리에서 실행하는 것이 좋습니다. 프로젝트 디렉터리에서 실행할 때는 -p <project-ID> 매개 변수를 생략할 수 있습니다. Cloud CLI 참조를 참조하십시오.

프로젝트 복제

다음 지침은 magento-cloud CLI 명령과 Git 명령을 조합하여 프로젝트를 로컬 워크스테이션에 복제합니다. magento-cloud CLI 명령의 전체 목록을 보려면 magento-cloud list 명령을 사용하십시오.

IMPORTANT
일부 Git 명령은 Adobe Commerce on cloud infrastructure 프로젝트에서 작업을 완료할 수 없습니다. 예를 들어 Git 명령을 사용하여 분기를 만들 수는 있지만 새 환경을 만들고 활성화할 수는 없습니다. magento-cloud environment:branch <branch-name> 명령을 사용하여 환경을 만들어야 환경이 활성 상태가 됩니다. 또는 Cloud Console을(를) 사용하여 활성 환경을 만들 수 있습니다. Cloud CLI 참조를 참조하십시오.

프로젝트 master 환경을 복제하려면:

  1. 파일 시스템 소유자 계정으로 로컬 워크스테이션에 로그인합니다.

  2. 웹 서버 또는 가상 호스트 docroot 디렉터리로 변경합니다.

  3. magento-cloud CLI를 사용하여 로그인합니다.

    code language-bash 
    magento-cloud login

  4. 프로젝트를 나열합니다.

    code language-bash 
    magento-cloud project:list

  5. 프로젝트 복제

    code language-bash 
    magento-cloud project:get <project-ID>

    메시지가 표시되면 디렉토리 이름을 입력합니다.

  6. magento2 디렉터리로 변경합니다.

  7. 프로젝트에 사용할 수 있는 환경을 나열합니다.

    code language-bash 
    magento-cloud environment:list
    note important
    IMPORTANT
    magento-cloud environment:list 명령은 환경 계층을 표시하지만 git branch 명령은 표시하지 않습니다.

  8. 원격 분기를 가져옵니다.

    code language-bash 
    git fetch origin

  9. 업데이트된 코드를 가져옵니다.

    code language-bash 
    git pull origin <environment-ID>
TIP
클라우드 인프라에서 Adobe Commerce과 함께 Git 기반 호스팅 서비스를 사용하는 방법에 대한 자세한 내용은 통합을 참조하십시오.

개발을 위한 분기 만들기

프로젝트를 복제하고 Adobe Commerce 관리자 계정 구성을 업데이트하면 개발을 위해 분기할 수 있습니다. 앞에서 설명한 대로 환경이 활성 ​이 되도록 하려면 magento-cloud environment:branch <branch-name> 명령 또는 Cloud Console을(를) 사용하여 환경을 만들어야 합니다.

  • Starter의 경우 staging에 대한 분기를 만든 다음 staging 분기를 기반으로 개발 분기를 만드십시오.
  • Pro의 경우 Integration 분기를 기반으로 개발 분기를 만드십시오.

개발 분기를 만들려면:

  1. 로컬 워크스테이션에서 프로젝트 디렉터리로 변경합니다.

  2. 프로젝트 워크플로에 권장되는 분기를 기반으로 환경을 만듭니다.

    code language-bash 
    magento-cloud branch <new-environment-name> integration

  3. 종속성을 업데이트합니다.

    code language-bash 
    composer --no-ansi --no-interaction install --no-progress --prefer-dist --optimize-autoloader

  4. [선택 사항] 환경의 백업을 만듭니다.

분기 병합

개발을 완료한 후 이 분기를 상위에 병합합니다.

  1. 코드 변경 내용 커밋 및 푸시:

    code language-bash 
    git add -A && git commit -m "Add message here"
    code language-bash 
    git push origin <branch-name>

  2. 상위 환경과 병합:

    code language-bash 
    magento-cloud environment:merge <environment-ID>

환경 삭제

더 이상 필요하지 않은 환경만 삭제합니다. 환경을 삭제한 후에는 환경을 복구할 수 없습니다.

WARNING
프로젝트의 master 분기를 삭제할 수 없습니다.

이 작업을 수행하려면 프로젝트 관리자, 환경 관리자 또는 계정 소유자여야 합니다. 클라우드 프로젝트에 대한 사용자 액세스 관리를 참조하십시오.

환경을 삭제하면 환경이 비활성(으)로 설정됩니다. 코드는 Git 분기에서 계속 사용할 수 있지만 더 이상 서비스나 데이터베이스를 포함하지 않습니다. 환경을 완전히 삭제하려면 해당 원격 Git 분기도 삭제해야 합니다.

환경을 삭제하려면:

  1. 로컬 워크스테이션에서 프로젝트 디렉터리로 변경합니다.

  2. 원격 서버에서 업데이트를 가져옵니다.

    code language-bash 
    git fetch

  3. 환경 분기를 삭제합니다.

    code language-bash 
    magento-cloud environment:delete <environment-ID>

    선택적으로, 여러 환경 ID를 delete 명령에 추가하여 한 번에 두 개 이상의 환경을 삭제할 수 있습니다.

    code language-bash 
    magento-cloud environment:delete <environment-1-ID> <environment-2-ID>

  4. 프롬프트에 응답하여 로컬 환경과 해당 원격 환경을 삭제합니다.

    code language-none 
    The environment <environment-ID> is currently active: deleting it will delete all associated data.
Are you sure you want to delete the environment <environment-ID>? [Y/n]

    환경을 삭제하면 비활성 상태가 됩니다.

    code language-none 
    Delete the remote Git branch too? [Y/n]

    원격 Git 분기를 삭제하면 프로젝트에서 환경이 제거됩니다.

  5. 환경이 삭제될 때까지 기다립니다.

    code language-none 
    Deleting environment <environment-ID>
Waiting for the activity...
  Deleting environment <project-id>-<environment-ID>-xxxxxx

  [============================]  1 min (complete)
Activity ID succeeded
Deleted remote Git branch <environment-ID>
Run git fetch --prune to remove deleted branches from your local cache.
TIP
비활성 환경을 활성화하려면 magento-cloud environment:activate 명령을 사용하십시오.

원격 환경과 상호 작용

SSH 키를 설정한 후 로컬 작업 공간에서 원격 환경에 연결하고 프로젝트 서비스와 상호 작용하고 설정을 수정할 수 있습니다.

recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26