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

프로젝트 구조

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

작성 대상:

  • 관리자
  • 개발자

클라우드 인프라 프로젝트의 Adobe Commerce에는 자격 증명 및 애플리케이션 구성에 필요한 파일이 포함되어 있습니다. 이러한 파일은 Adobe Commerce 버전에 따라에서 템플릿으로 사용할 수 있습니다. magento/magento-cloud GitHub 저장소에서 Adobe Commerce 버전을 기반으로 하는 클라우드 템플릿을 참조하십시오.

다음 표에서는 클라우드 프로젝트에 포함된 파일에 대해 설명합니다.

파일
설명
/.magento/routes.yaml
HTTP를 제공할 Apex 도메인 및 php 응용 프로그램으로 www을(를) 리디렉션하는 구성 파일입니다. 경로 구성을 참조하세요.
/.magento/services.yaml
MySQL 인스턴스(MariaDB), Redis 및 OpenSearch 또는 Elasticsearch을 정의하는 구성 파일입니다. 서비스 구성을 참조하세요.
/app
code 폴더는 사용자 지정 모듈에 사용됩니다. design 폴더는 사용자 지정 테마에 사용됩니다. etc 폴더에 응용 프로그램의 구성 파일이 있습니다.
/m2-hotfixes
사용자 지정 패치에 사용됩니다.
/update
지원 모듈에서 사용하는 서비스 폴더입니다.
.gitignore
무시할 파일 및 디렉터리를 지정합니다. .gitignore 참조을(를) 참조하십시오.
.magento.app.yaml
응용 프로그램을 빌드할 속성을 정의하는 구성 파일입니다. 응용 프로그램 구성을 참조하십시오.
.magento.env.yaml
빌드, 배포 및 배포 후 단계에 대한 구성 파일입니다. ece-tools 패키지에는 이 파일의 샘플이 포함되어 있습니다. 환경 구성을 참조하십시오.
composer.json
Adobe Commerce 및 구성 스크립트를 가져와 애플리케이션을 준비합니다. 필수 패키지를 참조하세요.
composer.lock
모든 패키지에 대한 버전 종속성을 저장합니다. 필수 패키지를 참조하세요.
magento-vars.php
변수를 사용하여 여러 저장소 및 사이트를 정의하는 데 사용됩니다.
NOTE
로컬 변경 내용을 원격 서버에 푸시할 때 배포 스크립트는 .magento 디렉터리의 구성 파일에 정의된 값을 사용한 다음, 스크립트는 디렉터리와 해당 내용을 삭제합니다. 로컬 개발 환경은 영향을 받지 않습니다.

응용 프로그램 루트 디렉터리

애플리케이션 루트 디렉토리의 위치는 환경에 따라 다릅니다.

  • Starter 및 Pro 통합: /app
  • 스타터 프로덕션: /<project-ID>
  • Pro 스테이징: /<project-ID>_stg
  • Pro 프로덕션: /<project-ID>

쓰기 가능한 디렉터리

원격 통합, 스테이징 및 프로덕션 환경은 읽기 전용입니다. 보안상의 이유로 다음 디렉터리는 only 쓰기 가능한 디렉터리입니다.

  • var
  • pub/static
  • pub/media
  • app/etc
  • /tmp
NOTE
프로덕션 및 스테이징 환경에서 3노드 클러스터의 각 노드에는 다른 노드와 공유되지 않는 /tmp 디렉터리가 있습니다.

파일 무시

클라우드 인프라 프로젝트 저장소에 Adobe Commerce이 있는 기본 .gitignore 파일이 있습니다. magento-cloud 저장소에서 최신 .gignore 파일을 봅니다. .gitignore 목록에 있는 파일을 추가하려면 커밋을 준비할 때 -f(강제) 옵션을 사용할 수 있습니다.

git add <path/filename> -f

기본 템플릿 변경

다음 단계를 사용하여 클라우드 인프라에서 Adobe Commerce에 대한 최신 기본 템플릿을 반영하도록 기존 프로젝트의 구조를 변경할 수 있습니다.

  1. 프로젝트를 로컬 워크스테이션에 복제합니다.

  2. extra 섹션에 대해 다음 값으로 composer.json 파일을 업데이트하십시오.

    code language-json 
    "extra": {
    "magento-force": true
    "magento-deploystrategy": "copy"
}

  3. 기본 템플릿용으로 설계된 .gitignore 파일을 추가합니다. 예를 들어 버전 2.2.6 템플릿에 .gitignore 파일이 필요한 경우 2.2.6🔗 파일에 대한 .gignore를 참조로 사용하십시오.

  4. git 캐시를 지웁니다.

    code language-bash 
    git rm -r --cached .

  5. 변경 사항을 추가하고 커밋합니다.

    code language-bash 
    git add -A && git commit -m "Update base template"
WARNING
배포 프로세스는 환경의 병합, 푸시 또는 동기화를 수행하거나 수동 재배포를 트리거할 때 시작되며, 이 기간 동안 Commerce 응용 프로그램은 유지 관리 모드에 있습니다. Adobe 프로덕션 환경의 경우, 서비스가 중단되지 않도록 사용량이 적은 시간 동안 이 작업을 완료하는 것이 좋습니다.
recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26