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

Cloud CLI

Last update: Thu Sep 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • 관리자
  • 개발자

magento-cloud CLI 도구를 사용하여 개발자와 시스템 관리자는 클라우드 프로젝트 및 환경을 관리하고 루틴을 수행하며 로컬에서 자동화 작업을 실행할 수 있습니다. magento-cloud CLI는 Cloud Console의 기능을 확장합니다. 로컬 워크스테이션에 magento-cloud CLI를 설치한 후 이를 사용하여 클라우드 인프라 Starter 및 Pro 통합 환경에서 Adobe Commerce을 관리할 수 있습니다.

NOTE
로컬 도구이며 이 방법을 사용하여 클라우드 환경(읽기 전용)에 설치할 수 없습니다. 배포 워크플로 ​를 통해서만 클라우드 환경에 모듈을 설치할 수 있습니다.

magento-cloud CLI를 설치하려면:

  1. 로컬 워크스테이션 ​에서 클라우드 프로젝트를 복제하려는 디렉터리와 파일 시스템 소유자에게 쓰기 액세스 권한이 있는 디렉터리로 변경합니다.

  2. magento-cloud CLI를 설치합니다.

    code language-bash 
    curl -sS https://accounts.magento.cloud/cli/installer | php

  3. 기본 프로필에 magento-cloud CLI를 추가합니다.

    code language-bash 
    export PATH=$PATH:$HOME/.magento-cloud/bin

  4. 업데이트된 bash 프로필을 다시 로드합니다.

    code language-bash 
    . ~/.bash_profile

  5. CLI를 시작하려면 magento-cloud을(를) 호출하고 메시지가 표시되면 클라우드 계정 자격 증명을 입력하십시오.

    code language-bash 
    magento-cloud
    code language-none 
    Welcome to Magento Cloud!
Please log in using your Magento Cloud account.
Your email address or username:

  6. magento-cloud 명령이 경로에 있는지 확인합니다. 다음 예제에서는 사용 가능한 명령을 나열합니다.

    code language-bash 
    magento-cloud list

일반 명령

Adobe은 Cloud 통합 환경을 관리하기 위해 이러한 명령을 설계했으며 -p <project-ID> 매개 변수를 생략할 수 있도록 프로젝트 디렉터리에서 magento-cloud CLI를 실행하는 것이 좋습니다.

일반적으로 사용되는 다음 magento-cloud CLI 명령 목록에는 필수 옵션만 포함되어 있습니다. 모든 명령에 --help 옵션을 사용하면 자세한 정보를 볼 수 있습니다.

명령
설명
magento-cloud login
프로젝트에 로그인.
magento-cloud list
CLI 도구에 사용할 수 있는 명령을 나열합니다.
magento-cloud environment:list
현재 프로젝트의 환경을 나열합니다.
magento-cloud environment:checkout
기존 환경을 확인합니다.
magento-cloud environment:merge -e
이 환경의 변경 내용을 상위 항목과 병합합니다.
magento-cloud variables
이 환경의 목록 변수입니다.
magento-cloud ssh
SSH를 사용하여 원격 환경에 연결합니다.
magento-cloud url
브라우저에서 Adobe Commerce 상점을 엽니다.
magento-cloud web
Cloud Console을 엽니다.

환경 명령

환경 name ​은(는) 환경 이름에 공백이나 대문자를 사용하는 경우에만 환경 ID ​과(와) 다릅니다. 환경 ID는 모든 소문자, 숫자 및 허용되는 기호로 구성됩니다. 환경 이름의 대문자는 ID에서 소문자로 변환되고 환경 이름의 공백은 대시로 변환됩니다.

환경 이름 cannot ​에는 Linux 셸 또는 정규 표현식에 예약된 문자가 포함됩니다. 금지된 문자에는 중괄호({ }), 괄호, 별표(*), 꺾쇠 괄호(< >), 앰퍼샌드(&), 백분율(%) 및 기타 문자가 포함됩니다.

magento-cloud environment:list 명령은 환경 계층을 표시하지만 git branch은(는) 표시하지 않습니다. 중첩된 환경이 있는 경우 다음을 사용합니다.

magento-cloud environment:list

환경 재배포

푸시를 사용하지 않고 재배포를 트리거합니다. 재배포할 환경을 확인하고 확인합니다. 보류 중인 상태의 빌드가 있는 경우 재배포를 사용하지 마십시오.

magento-cloud environment:redeploy

샘플 응답:

Are you sure you want to redeploy the environment <environment-name>? [Y/n]
WARNING
배포 프로세스는 환경의 병합, 푸시 또는 동기화를 수행하거나 수동 재배포를 트리거할 때 시작되며, 이 기간 동안 Commerce 응용 프로그램은 유지 관리 모드에 있습니다. Adobe 프로덕션 환경의 경우, 서비스가 중단되지 않도록 사용량이 적은 시간 동안 이 작업을 완료하는 것이 좋습니다.

Git 명령

이러한 명령 중 일부는 Git 명령과 유사합니다. magento-cloud 명령은 추가 기능을 사용하여 Git 기반 클라우드 프로젝트에 직접 연결합니다. magento-cloud CLI를 사용하지 않고 분기를 만드는 경우 "활성화"되지 않으며 원격 환경에 변경 내용을 푸시할 때 자동으로 빌드되지 않습니다. magento-cloud CLI 명령에 활성화가 포함되어 있습니다.

분기를 만들려면 magento-cloud 명령을 사용하여 분기가 활성화되도록 합니다.

magento-cloud environment:branch <new-name> <parent-branch>

분기 상태의 경우:

  • magento-cloud env 명령을 사용하여 환경 분기의 목록과 해당 상태(활성 또는 비활성)를 봅니다.
  • magento-cloud environment:activate 명령을 사용하여 환경 분기를 활성화합니다.

빈 Git 커밋을 푸시하여 배포를 트리거합니다. For example:

git commit --allow-empty -m "redeploy" && git push <branch-name>

사용자 추가와 같은 일부 작업은 배포로 이어지지 않습니다.

환경 분기 만들기

다음 단계에서는 CLI 및 Git 명령을 상호 교환하여 로컬 환경을 관리하는 방법을 보여 줍니다.

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

  2. 파일 시스템 소유자(으)로 전환합니다.

  3. 프로젝트에 로그인.

    code language-bash 
    magento-cloud login

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

    code language-bash 
    magento-cloud project:list

  5. 프로젝트의 환경을 나열합니다. 모든 환경에는 코드, 데이터베이스, 환경 변수, 구성 및 서비스를 포함하는 활성 Git 분기가 포함되어 있습니다.

    code language-bash 
    magento-cloud environment:list
    note note
    NOTE
    magento-cloud environment:list 명령은 환경 계층을 표시하지만 git branch 명령은 그렇지 않으므로 이 명령을 사용하는 것이 중요합니다.

  6. 원본 분기를 가져와 최신 코드를 가져옵니다.

    code language-bash 
    git fetch origin

  7. 특정 분기 및 환경을 체크아웃하거나 로 전환합니다.

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

    Git 명령은 Git 분기만 체크아웃합니다. magento-cloud checkout 명령은 분기를 체크아웃하고 활성 환경으로 전환합니다.

    note tip
    TIP
    magento-cloud environment:branch <environment-name> <parent-environment-ID> 명령 구문을 사용하여 환경 분기를 만들 수 있습니다. 환경 분기를 만들고 활성화하는 데 약간의 추가 시간이 걸릴 수 있습니다.

  8. 환경 ID를 사용하여 업데이트된 코드를 로컬로 가져옵니다. 환경 분기가 새로운 경우에는 필요하지 않습니다.

    code language-bash 
    git pull origin <environment-ID>

  9. (선택 사항) 환경의 스냅숏을(를) 백업으로 만듭니다.

    code language-bash 
    magento-cloud snapshot:create -e <environment-ID>

CLI 업데이트

magento-cloud CLI는 로그인할 때 사용 가능한 업데이트를 확인하지만 self:update 명령을 사용하여 업데이트를 확인할 수 있습니다. 업데이트를 사용할 수 있는 경우 지침에 따라 CLI를 업데이트합니다.

magento-cloud CLI가 최신 상태이면 다음 응답이 표시됩니다.

magento-cloud update

Checking for Magento Cloud CLI updates (current version: X.XX.X)
No updates found
recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26