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

Cloud Console (으)로 분기 관리

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • 개발자

Cloud Console 또는 magento-cloud CLI를 사용하여 환경을 관리할 수 있습니다. 프로젝트 파일은 Git 저장소에 저장됩니다. Git 명령을 사용하여 코드를 관리할 수 있지만, magento-cloud CLI는 플랫폼 기능과 상호 작용하도록 설계된 반면 Git 명령은 그렇지 않습니다. 클라우드 CLI 항목에서 Git 명령을(를) 참조하십시오.

이 항목에서는 Cloud Console을(를) 사용하여 다음을 수행하는 방법에 대해 설명합니다.

  • 환경 추가 또는 삭제
  • 상위 환경에서 (git pull) 동기화
  • 부모 환경에 (git push) 병합
TIP
Pro 스테이징 및 프로덕션 환경에서는 분기를 만들 수 없습니다. master 분기에서 분기할 수 있습니다.

환경 만들기

분기 전략은 개발 분기에 코드를 개발하고 확장을 추가하는 일반적인 Git 워크플로를 사용합니다. Starter 및 Pro 아키텍처 개요를 참조하십시오.

  • 스타터의 경우 master 분기에서 staging 분기를 만든 다음 개발을 위해 staging에서 분기를 만드십시오.
  • Pro의 경우 Integration 환경에서 개발 분기를 만드십시오.

귀하의 계정은 제한된 수의 활성 분기 {width="32"} (active) and an unlimited number of inactive branch {width="32"}(비활성) 개발 분기를 지원합니다. Cloud Console 또는 Cloud CLI만 사용하여 분기를 추가하거나 삭제하여 활성 및 비활성 분기를 관리합니다. 분기를 삭제하려면 먼저 환경 목록에 비활성(으)로 남아 있는 분기를 비활성화합니다. 나중에 분기를 다시 활성화하거나 환경 설정에서 또는 Cloud CLI를 사용하여 분기를 삭제할 수 있습니다.

개발을 위해 추가 활성 환경이 필요한 경우 지원 티켓을 제출하세요.

분기를 추가하려면:

  1. Cloud Console에 로그인합니다.

  2. 모든 프로젝트 목록에서 프로젝트를 선택하십시오.

  3. 환경을 선택합니다.

    note tip
    TIP
    새 분기가 이 환경에서 복제됩니다. 만들려는 환경과 유사한 상위 환경을 선택합니다.

  4. Branch ​을(를) 클릭합니다.

    분기 만들기 {width="150"}

  5. 분기 시작… 양식에서 분기 이름을 입력하십시오.

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

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

  6. Environment type 선택.

  7. Create Branch ​을(를) 클릭합니다.

  8. 환경이 배포되는 동안 잠시 기다려 주십시오.

    배포 중 환경 상태는 진행 중 ​입니다. 배포가 성공하면 성공 ​에 대한 상태가 녹색 확인 표시로 변경됩니다.

비활성 분기 만들기

Adobe Commerce Cloud 콘솔 또는 CLI에서는 비활성 분기를 만들 수 없습니다. 비활성 분기를 만들려면 Git 저장소에서 만들고 명령의 environment.Parent 옵션을 사용하여 푸시합니다.

git push -o "environment.Parent=<parent branch>" <origin> <branch>

환경 삭제

환경을 삭제하려면 먼저 환경을 비활성화해야 합니다. 환경이 비활성화되면 삭제할 수 있습니다.

환경을 비활성화하려면:

  1. Cloud Console에 로그인합니다.

  2. 모든 프로젝트 목록에서 프로젝트를 선택하십시오.

  3. 탐색 모음 환경 목록에서 환경을 선택하십시오.

  4. 상단 탐색 막대의 오른쪽에 있는 구성 아이콘을 클릭하면 환경 설정이 열립니다.

  5. General ​탭에서​ Deactivate environment 섹션으로 스크롤한 다음 Deactivate environment and delete data ​을(를) 클릭하고 지침을 따릅니다.

환경 동기화

환경(또는 분기)을 동기화하는 것은 git pull origin <parent>과(와) 동일합니다. 상위 환경에서 업데이트된 코드를 동기화할 수 있습니다. Cloud Console을(를) 통해 모든 Starter 및 Pro 환경에 이 기능을 사용할 수 있습니다.

Pro 플랜의 경우 스테이징 및 프로덕션에서 master 분기로 동기화할 수 있습니다. 이 동기화는 데이터를 가져오지 않고 코드만 가져오고 푸시합니다. 데이터를 동기화하려면 데이터베이스 데이터를 덤프하고 다른 환경의 데이터베이스로 푸시합니다. 정적 파일 및 데이터 마이그레이션 및 배포를 참조하세요.

환경을 동기화하려면:

  1. Cloud Console에 로그인합니다.

  2. 모든 프로젝트 목록에서 프로젝트를 선택하십시오.

  3. 환경 목록에서 동기화할 분기의 이름을 클릭합니다.

  4. (동기화)를 클릭합니다.

    환경 동기화 {width="150"}

  5. 동기화할 항목을 선택하십시오.

    • 데이터 바꾸기 - (데이터 및 파일) 상위 분기의 데이터베이스 및 컨텐츠 파일에서 변경 사항을 동기화합니다.
    • 병합—(코드) 상위 분기에서 업데이트된 코드를 동기화합니다.

    또한 CLI 명령을 만들어 복사 및 사용할 수 있습니다.

  6. 동기화 ​를 클릭합니다.

상위 환경과 병합

환경(또는 분기)을 병합하는 것은 git push origin과(와) 동일합니다. 를 병합하여 업데이트된 코드를 환경에서 상위 환경으로 푸시합니다. 이 코드를 master에 병합할 수 있습니다. merge 명령을 사용하여 스테이징 및 프로덕션에 배포할 수 있습니다.

상위 환경과 병합하려면:

  1. Cloud Console에 로그인합니다.

  2. 모든 프로젝트 목록에서 프로젝트를 선택하십시오.

  3. 환경 목록에서 병합할 분기의 이름을 클릭합니다.

  4. (병합)을 클릭합니다.

    환경 병합 {width="150"}

  5. 병합 ​을 클릭하고 작업을 확인합니다.

로그 보기

Cloud Console을(를) 통해 빌드, 배포 및 배포 기록을 비롯한 환경에 대한 다양한 로그를 검토할 수 있습니다.

Starter ​의 경우 빌드 및 배포 로그와 배포 기록을 검토할 수 있습니다. 이러한 환경에는 master(프로덕션) 분기 및 이 분기에서 만들어진 모든 분기가 포함됩니다.

Pro ​의 경우 각 환경에서 다음 로그를 검토할 수 있습니다.

  • 통합 - 구축 및 구축, 구축 기록
  • 스테이징 - 로그 및 배포 내역을 빌드합니다. SSH를 사용하여 서버에 로그인하여 배포 로그를 확인합니다.
  • 프로덕션 - 로그 및 배포 내역을 작성합니다. SSH를 사용하여 서버에 로그인하여 배포 로그를 확인합니다.

Cloud Console ​에서 로그를 보려면:

  1. Cloud Console에 로그인합니다.

  2. 모든 프로젝트 목록에서 프로젝트를 선택하십시오.

  3. 환경을 선택합니다.

    환경 보기는 최근 이벤트, 시도한 작업당 하나의 항목(동기화, 병합, 분기, 백업 등)을 표시하는 활동 목록을 제공합니다. 전체 배포 기록을 보려면 모두 ​를 클릭하십시오.

  4. 빌드 로그를 보려면 계정에서 배포 레코드당 성공 또는 실패 링크를 선택합니다.

TIP
드롭다운 목록의 필터링 기준 아이콘을 클릭하고 보려는 메시지 유형을 선택합니다.

개인 Git 저장소에서 코드 가져오기

Adobe Commerce on cloud infrastructure 프로젝트에는 개인 Git 저장소의 코드가 포함될 수 있습니다. 예를 들어 개인 저장소에 사용자 지정 모듈 또는 테마에 대한 코드가 있을 수 있습니다. 이렇게 하려면 프로젝트의 공개 SSH 키를 개인 Git 저장소에 추가하고 프로젝트 composer.json 파일을 업데이트해야 합니다.

배포 키를 개인 GitHub 저장소에 추가하려면 해당 저장소의 관리자여야 합니다. GitHub에서는 한 저장소에만 배포 키를 사용할 수 있습니다.

프로젝트에서 여러 저장소에 액세스하려는 경우 SSH 키를 자동화된 사용자 계정에 첨부할 수 있습니다. 이 계정은 사람이 사용하지 않으므로 컴퓨터 사용자라고 합니다. 공동 작업자로 컴퓨터 계정을 추가하거나 저장소에 액세스할 수 있는 팀에 컴퓨터 사용자를 추가합니다.

INFO
Adobe은 이 코드를 프로젝트 Git 저장소에 추가하고 병합하는 것을 권장합니다. 연결을 구성하지 않으면 빌드 문제가 발생할 수 있습니다.

SSH 공개 키를 찾으려면:

  1. Cloud Console에 로그인합니다.

  2. 모든 프로젝트 목록에서 프로젝트를 선택하십시오.

  3. 맨 위 탐색 막대의 오른쪽에 있는 구성 아이콘을 클릭합니다.

  4. 프로젝트 설정 ​에서 Deploy Key ​을(를) 클릭합니다.

  5. 다음 Git 기반 방법 중 하나에 사용할 배포 키를 클립보드에 복사합니다.

GitHub

GitHub 배포 키 입력

GitHub에서 배포 키는 기본적으로 읽기 전용입니다.

프로젝트 공개 키를 GitHub 배포 키로 입력하려면:

  1. 관리자로 GitHub 저장소에 로그인합니다.

  2. 저장소 Settings 탭을 클릭합니다.

    note note
    NOTE
    이 옵션이 표시되지 않으면 저장소 관리자로 로그인되지 않은 것이므로 이 작업을 완료할 수 없습니다. GitHub 저장소 관리자에게 이 작업을 수행하도록 요청하십시오.

  3. 왼쪽 탐색의 설정 탭에서 Deploy Keys ​을(를) 클릭합니다.

  4. Add deploy key ​을(를) 클릭합니다.

  5. 나타나는 메시지를 따릅니다.

composer.json에서 <user>@<host>:<.git</code> 형식을 사용하거나 비표준 포트를 사용하는 경우 ssh://<user>@<host>:<port>/<path>.git을(를) 사용하십시오.

Bitbucket

Bitbucket 배포 키 입력

프로젝트 공개 키를 Bitbucket 배포 키로 입력하려면:

  1. 관리자로 Bitbucket 저장소에 로그인합니다.

  2. 왼쪽 탐색에서 Settings ​을(를) 클릭합니다.

  3. 일반 > Deployment Keys ​을(를) 클릭합니다.

  4. Add Key ​을(를) 클릭합니다.

  5. 나타나는 메시지를 따릅니다.

GitLab

GitLab 배포 키 입력

프로젝트에 대한 공개 SSH 키를 GitLab 배포 키로 추가하려면:

  1. GitLab 저장소에 소유자로 로그인합니다.

  2. 프로젝트에 대해 파이프라인 옵션이 활성화되어 있는지 확인합니다.

    1. 프로젝트 설정에서 Visibility, project, features, permissions 섹션을 확장합니다.
    2. 필요한 경우 Pipelines ​을(를) 클릭하여 옵션을 사용하도록 설정합니다.

  3. 공개 SSH 키를 CI/CD 설정에 추가합니다.

    1. 왼쪽 탐색에서 설정 > CI / CD ​을(를) 클릭합니다.
    2. 키 배포 확장 ​을 클릭하여 키를 구성합니다.
    3. 키 배포 양식에서 Title 필드에 배포 키 이름을 추가하고 Key 필드에 공개 SSH 키를 붙여 넣습니다.
    4. 구성을 저장하려면 Add Key ​을(를) 클릭합니다.

안전한 환경 및 분기

Cloud Console을(를) 사용하여 웹 브라우저를 통해 모든 위치에서 프로젝트와 환경에 액세스할 수 있습니다. 프로덕션 환경, 스토어 및 사이트에 대한 보안 설정이 있을 수 있습니다. 이 섹션은 개발자, DBA 등을 위한 통합 및 스테이징 환경을 보호하는 데 도움이 됩니다.

WARNING
다음 방법을 사용하여 Pro 스테이징 및 프로덕션 환경을 보호하지 마십시오. 이는 Fastly 캐싱을 중단합니다. Adobe Commerce용 Fastly CDN에서 사용할 수 있는 차단 기능을 사용하십시오.

환경을 보호하려면:

  1. Cloud Console에 로그인합니다.

  2. 모든 프로젝트 목록에서 프로젝트를 선택하십시오.

  3. 환경을 선택하고 탐색 모음에서 구성 아이콘을 클릭합니다.

  4. 환경 설정 일반 탭에서 HTTP access control enabled ​에 대해 설정 ​을 클릭하여 보안 액세스를 사용하도록 설정합니다. 자격 증명과 IP 주소 중에서 선택하여 액세스를 필터링할 수 있습니다.

  5. 자격 증명으로 필터링하려면 Add Login ​을(를) 클릭하고 사용자 이름과 암호를 입력한 다음 Add Login ​을(를) 클릭하여 추가합니다.

  6. IP 주소로 필터링하려면 deny 또는 allow 목록에 IP 주소를 입력하십시오. For example:

    code language-text 
    123.456.789.111/29 allow
123.456.789.112/29 allow
234.123.567.111/29 allow
0.0.0.0/0 deny

  7. Save ​을(를) 클릭합니다. 이렇게 하면 환경이 다시 배포되어 보안 및 설정이 업데이트됩니다. Adobe은 보안 설정을 완료한 후 환경을 테스트할 것을 권장합니다.

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