스테이징 및 프로덕션에 배포

Last update: Wed Apr 03 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

관리자
개발자

배포 및 라이브 진행 프로세스는 개발에서 시작하여 스테이징으로 이어지고 프로덕션에서 라이브로 끝납니다. Adobe은 일관된 구성을 보장하는 완벽한 환경 솔루션을 제공합니다. 모든 환경에서는 Storefront 및 Admin에 대한 직접 URL 액세스와 CLI 명령에 대한 SSH 액세스를 지원합니다.

스토어를 배포할 준비가 되면 프로덕션에 배포하기 전에 스테이징 환경에서 배포 및 테스트를 완료해야 합니다. 이 섹션에서는 빌드 및 배포 프로세스, 데이터 및 콘텐츠 마이그레이션, 테스트에 대한 심층적인 지침과 정보를 제공합니다.

TIP

Adobe은 백업 배포 전 환경의

또한 을 활성화할 수 있습니다 New Relic을 사용하여 배포 추적 배포 이벤트를 모니터링하고 배포 간 성능을 분석하는 데 도움이 됩니다.

스타터 배포 플로우

Adobe은 staging 에서 분기 master 스타터 계획 개발 및 배포를 가장 잘 지원하기 위한 분기. 그러면 4개의 활성 환경 중 2개를 준비할 수 있습니다. master 프로덕션 및 staging 스테이징용

프로세스에 대한 자세한 내용은 스타터 개발 및 배포 워크플로.

Pro 배포 플로우

Pro에는 글로벌 분기인 두 개의 활성 분기가 있는 대규모 통합 환경이 포함되어 있습니다 master 분기, 스테이징 및 프로덕션 분기. 프로젝트를 만들 때 코드를 사이트 빌드 및 배포를 분기, 개발 및 추진할 준비가 되었습니다. 통합 환경에는 여러 분기가 있을 수 있지만 스테이징 및 프로덕션 환경에는 각 환경에 대해 하나의 분기만 있습니다.

프로세스에 대한 자세한 내용은 Pro 개발 및 배포 워크플로우.

스테이징에 코드 배포

스테이징 환경은 데이터베이스, 웹 서버 및 Fastly와 New Relic을 포함한 모든 서비스를 포함하는 프로덕션에 가까운 환경을 제공합니다. 를 통해 완전히 푸시, 병합 및 배포할 수 있습니다. Cloud Console 또는 Cloud CLI 명령 터미널 응용 프로그램을 통해.

를 사용하여 코드 배포 Cloud Console

다음 Cloud Console 는 Starter 및 Pro 플랜을 위한 통합, 스테이징 및 프로덕션 환경에서 코드를 생성, 관리 및 배포하는 기능을 제공합니다.

Pro 프로젝트의 경우 스테이징에 통합 분기 배포:

로그인 을 프로젝트에 추가합니다.
다음 항목 선택 integration 분기입니다.
다음 항목 선택 병합 스테이징에 배포할 옵션입니다.

{width="150"}
모두 완료 테스트 스테이징 환경에서.
스테이징이 준비되면 병합 프로덕션에 배포할 옵션입니다.

Starter의 경우 스테이징에 개발 분기 배포:

로그인 을 프로젝트에 추가합니다.
준비된 코드 분기를 선택합니다.
다음 항목 선택 병합 스테이징에 배포할 옵션입니다.

{width="150"}
모두 완료 테스트 스테이징 환경에서.
스테이징이 준비되면 병합 프로덕션에 배포 옵션(master).

명령줄로 코드 배포

Cloud CLI는 코드를 배포하는 명령을 제공합니다. 프로젝트에 대한 SSH 및 Git 액세스 권한이 필요합니다.

1단계: 통합 환경 배포 및 테스트

프로젝트에 로그인한 후 통합 환경을 확인합니다.

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

로컬 통합 환경을 원격 환경과 동기화:

code language-bash
`magento-cloud environment:synchronize <environment-ID>`

환경의 스냅샷을 백업으로 만듭니다.

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

필요에 따라 로컬 분기의 코드를 업데이트합니다.

환경에 변경 사항을 추가, 커밋 및 푸시합니다.

code language-bash
`git add -A && git commit -m "Commit message" && git push origin <environment-ID>`

사이트 테스트를 완료합니다.

2단계: 스테이징에 대한 변경 사항 병합 및 배포

스테이징 환경을 확인합니다.

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

로컬 스테이징 환경을 원격 환경과 동기화합니다.

code language-bash
`magento-cloud environment:synchronize <environment-ID>`

환경의 스냅샷을 백업으로 만듭니다.

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

배포할 스테이징에 통합 환경을 병합합니다.

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

사이트 테스트를 완료합니다.

3단계: 프로덕션에 배포

로컬 프로덕션 환경의 스냅샷을 체크 아웃, 동기화 및 생성합니다.

스테이징 환경을 프로덕션에 병합하여 배포합니다.

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

사이트 테스트를 완료합니다.

정적 파일 마이그레이션

정적 파일 저장 위치: mounts. 로컬 환경과 같은 소스 마운트 위치에서 대상 마운트 위치로 파일을 마이그레이션하는 방법에는 두 가지가 있습니다. 두 방법 모두 rsync 유틸리티를 사용하지만 Adobe은 magento-cloud 로컬 환경과 원격 환경 간에 파일을 이동할 수 있는 CLI. 및 Adobe은 rsync 원격 소스에서 다른 원격 위치로 파일을 이동할 때의 메서드입니다.

CLI를 사용하여 파일 마이그레이션

다음을 사용할 수 있습니다. mount:upload 및 mount:download 로컬 환경과 원격 환경 간에 파일을 마이그레이션하는 CLI 명령 두 명령 모두 rsync 그러나 CLI 명령은 Adobe Commerce on cloud infrastructure 환경에 맞게 구성된 옵션과 프롬프트를 제공합니다. 예를 들어 옵션 없이 단순 명령을 사용하는 경우 CLI는 업로드 또는 다운로드할 마운트 또는 마운트를 선택하라는 메시지를 표시합니다.

magento-cloud mount:download

샘플 응답:

Enter a number to choose a mount to download from:
  [0] app/etc
  [1] pub/static
  [2] var
  [3] pub/media
  [4] All mounts
 > 3

Target directory: ~/pub/media/

Downloading files from the remote mount pub/media to pub/media

Are you sure you want to continue? [Y/n] Y

로컬에서 파일을 업로드하려면 pub/media/ 원격 폴더 pub/media/ 현재 환경의 폴더:

magento-cloud mount:upload --source /path/to/project/pub/media/ --mount pub/media/

샘플 응답:

Uploading files from pub/media to the remote mount pub/media

Are you sure you want to continue? [Y/n] Y

  building file list ...   done
  ./
  sample-file.jpeg

  sent 8.43K bytes  received 48 bytes  3.39K bytes/sec
  total size is 154.57K  speedup is 18.23

사용 --help 옵션 mount:upload 및 mount:download 추가 옵션을 보는 명령입니다. 예를 들어 --delete 마이그레이션 도중 관련 없는 파일을 제거하는 옵션입니다.

rsync를 사용하여 파일 마이그레이션

또는 rsync 유틸리티를 사용하여 파일을 마이그레이션할 수 있습니다.

rsync -azvP <source> <destination>

이 명령은 다음 옵션을 사용합니다.

a-archive
z-마이그레이션 도중 파일 압축
v-verbose
P-일부 진행

다음을 참조하십시오 rsync 도와주세요.

NOTE

원격 환경에서 원격 환경으로 직접 미디어를 전송하려면 SSH 에이전트 전달을 활성화해야 합니다. GitHub 지침.

정적 파일을 원격 환경에서 원격 환경으로 직접 마이그레이션하려면(빠른 접근 방식):

SSH를 사용하여 소스 환경에 로그인합니다. 를 사용하지 마십시오. magento-cloud CLI. 사용 -A 옵션은 인증 에이전트 연결의 전달을 활성화하므로 중요합니다.

note tip
TIP
을(를) 찾으려면 SSH 액세스 의 링크 Cloud Console을 클릭하고 환경을 선택한 다음 을 클릭합니다. 사이트 액세스.

code language-bash
`ssh -A <environment_ssh_link@ssh.region.magento.cloud>`

사용 rsync 복사 명령 pub/media 소스 환경에서 다른 원격 환경으로 디렉터리.

code language-bash
`rsync -azvP pub/media/ <destination_environment_ssh_link@ssh.region.magento.cloud>:pub/media/`

다른 원격 환경에 로그인하여 파일이 성공적으로 마이그레이션되었는지 확인합니다.

데이터베이스 마이그레이션

WARNING

데이터베이스 가져오기 및 내보내기 작업은 시간이 오래 걸릴 수 있으며, 이는 사이트 성능 및 가용성에 영향을 미칠 수 있습니다. 사용량이 적은 시간 동안 가져오기 및 내보내기 작업을 예약하여 프로덕션 사이트의 성능 저하 또는 중단을 방지합니다.

recommendation-more-help

전제 조건: 데이터베이스 덤프(3단계 참조)에는 데이터베이스 트리거가 포함되어야 합니다. 덤프하는 경우 다음을 보유하고 있는지 확인합니다. TRIGGER 권한.

IMPORTANT

통합 환경 데이터베이스는 엄격히 개발 테스트를 위한 것이며 스테이징 및 프로덕션으로 마이그레이션하지 않으려는 데이터를 포함할 수 있습니다.

지속적인 통합 배포의 경우 Adobe 권장하지 않음 통합에서 스테이징 및 프로덕션으로 데이터 마이그레이션. 테스트 데이터를 전달하거나 중요한 데이터를 덮어쓸 수 있습니다. 중요한 구성은 다음을 사용하여 전달됩니다. 구성 파일 및 setup:upgrade 빌드 및 배포 중 명령.

style

shade-box

Adobe 추천 프로덕션에서 스테이징으로 데이터를 마이그레이션하여 모든 서비스 및 설정을 사용하여 프로덕션에 가까운 환경에서 사이트와 스토어를 완전히 테스트합니다.

NOTE

원격 환경에서 원격 환경으로 직접 미디어를 전송하려면 ssh 에이전트 전달을 활성화해야 합니다. GitHub 지침.

데이터베이스 백업

데이터베이스의 백업을 만드는 것이 좋습니다. 다음 절차에서는 의 지침을 사용합니다 데이터베이스 백업.

데이터베이스를 덤프하려면:

SSH를 사용하여 원격 환경에 로그인 복사할 데이터베이스가 들어 있습니다.

환경 관계를 나열하고 데이터베이스 로그인 정보를 확인합니다.

code language-bash
`php -r 'print_r(json_decode(base64_decode($_ENV["MAGENTO_CLOUD_RELATIONSHIPS"]))->database);'`

Pro Staging 및 Production의 경우 데이터베이스 이름은 MAGENTO_CLOUD_RELATIONSHIPS 변수(일반적으로 애플리케이션 이름 및 사용자 이름과 동일함)입니다.

데이터베이스의 백업을 만듭니다. DB 덤프의 대상 디렉토리를 선택하려면 --dump-directory 옵션을 선택합니다.

Starter 환경 및 Pro 통합 환경의 경우 main 를 데이터베이스 이름으로 사용:

code language-bash
`php vendor/bin/ece-tools db-dump main`

덤프 옵션:

--dump-directory=<dir>—데이터베이스 덤프의 대상 디렉터리를 선택합니다.
--remove-definers—데이터베이스 덤프에서 DEFINER 문 제거

ECE-Tools 메서드가 선호되지만 다른 방법은 GZIP 형식의 기본 MySQL을 사용하여 데이터베이스 덤프 파일을 만드는 것입니다.

code language-bash
`mysqldump -h <database-host> --user=<database-username> --password=<password> --single-transaction --triggers <database-name> \| gzip - > /tmp/database.sql.gz`

대상 환경에 이중 인증을 구성한 경우 데이터베이스 마이그레이션 후 관련 2FA 테이블을 제외하여 다시 구성하지 않는 것이 좋습니다.

code language-bash

code language-bash
`mysqldump -h <database-host> --user=<database-username> --password=<password> --single-transaction --triggers --ignore-table=<database-name>.tfa_user_config --ignore-table=<database-name>.tfa_country_codes <database-name> \| gzip - > /tmp/database.sql.gz`

mysqldump -h <database-host> --user=<database-username> --password=<password> --single-transaction --triggers --ignore-table=<database-name>.tfa_user_config --ignore-table=<database-name>.tfa_country_codes <database-name> | gzip - > /tmp/database.sql.gz

유형 logout ssh 연결을 종료합니다.

데이터베이스 삭제 및 다시 만들기

데이터를 가져올 때 데이터베이스를 삭제하고 만들어야 합니다.

데이터베이스를 삭제하고 다시 만들려면:

설정 SSH 터널 원격 환경에 연결합니다.

데이터베이스 서비스에 연결합니다.

code language-bash
`mysql --host=127.0.0.1 --user='<database-username>' --pass='<user-password>' --database='<name>' --port='<port>'`

위치: MariaDB [main]> 프롬프트에서 데이터베이스를 삭제합니다.

Starter 및 Pro 통합의 경우

code language-shell
`drop database main;`

프로덕션의 경우:

code language-shell
`drop database <cluster-id>;`

스테이징의 경우:

code language-shell
`drop database <cluster-ID_stg>;`

데이터베이스를 다시 만듭니다.

Starter 및 Pro 통합의 경우

code language-shell
`create database main;`

프로덕션용 가져오기:

code language-shell
`zcat <cluster-ID>.sql.gz \| sed -e 's/DEFINER[ ]=[ ][^]\/\/' \| mysql -h 127.0.0.1 -p -u <database-username> <database-name>;`

스테이징을 위해 가져오기:

code language-shell
`zcat <cluster-ID_stg>.sql.gz \| sed -e 's/DEFINER[ ]=[ ][^]\/\/' \| mysql -h 127.0.0.1 -p -u <database-username> <database-name>;`

05f2f56e-ac5d-4931-8cdb-764e60e16f26