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

서비스 구성

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

작성 대상:

  • 관리자
  • 개발자

services.yaml 파일은 MySQL, Redis, Elasticsearch 또는 OpenSearch와 같은 클라우드 인프라에서 Adobe Commerce이 지원하고 사용하는 서비스를 정의합니다. 외부 서비스 공급자에 가입할 필요가 없습니다.

NOTE
.magento/services.yaml 파일은 프로젝트의 .magento 디렉터리에서 로컬로 관리됩니다. 이 구성은 통합 환경에서 필요한 서비스 버전을 정의하기 위한 빌드 프로세스 중에만 액세스되며 배포가 완료되면 제거되므로 서버에서 찾을 수 없습니다.

배포 스크립트는 .magento 디렉터리의 구성 파일을 사용하여 구성된 서비스로 환경을 프로비전합니다. 응용 프로그램이 .magento.app.yaml 파일의 relationships 속성에 포함된 경우 해당 응용 프로그램에서 서비스를 사용할 수 있게 됩니다. services.yaml 파일에 type 및 disk 값이 있습니다. 서비스 유형은 서비스 name 및 version ​을(를) 정의합니다.

서비스 구성을 변경하면 배포에서 업데이트된 서비스로 환경을 프로비저닝하게 되며, 이는 다음 환경에 영향을 줍니다.

  • 프로덕션 master을(를) 포함한 모든 시작 환경
  • Pro 통합 환경
TIP
Pro 프로젝트의 경우 Staging 및 Production 환경에서만 서비스를 설치하거나 업데이트하려면 Adobe Commerce 지원 티켓을 제출해야 합니다.
필요한 서비스 변경 사항을 표시하고 업데이트된 .magento.app.yaml 및 services.yaml 파일을 포함하고 티켓에 PHP 버전을 명시하십시오. PHP 버전, 확장, 환경 설정에 대한 셀프 서비스 변경 내용은 응용 프로그램 구성 ​의 PHP 설정을 참조하십시오.
라이브 프로덕션 환경(Pro 전용)을 변경하려면 최소 48시간 이상 알림이 필요합니다. 이를 통해 클라우드 인프라 팀은 리소스를 마샬링하고 보안 업그레이드를 수행할 수 있는 충분한 시간을 확보할 수 있습니다. 공지 기간은 인프라 팀이 요청을 승인하고 주말을 제외하고 업그레이드 일정을 잡을 때 시작됩니다. 예를 들어 월요일에 서비스 업그레이드를 완료하려면 예약된 업그레이드에 대한 승인을 수요일까지 받아야 합니다. 최대 수요 기간 동안 요청을 처리하는 데 더 많은 시간이 걸릴 수 있습니다.

기본 및 지원 서비스

클라우드 인프라는 다음 서비스를 지원하고 배포합니다.

현재 기본 services.yaml 파일에서 기본 버전 및 디스크 값을 볼 수 있습니다. 다음 샘플은 services.yaml 구성 파일에 정의된 mysql, redis, opensearch 또는 elasticsearch 및 rabbitmq 서비스를 보여줍니다.

mysql:
    type: mysql:10.4
    disk: 5120

redis:
    type: redis:6.2

opensearch:
    type: opensearch:2  # minor version not required; uses latest
    disk: 1024

rabbitmq:
    type: rabbitmq:3.9
    disk: 1024

서비스 값

서비스 ID 및 서비스 유형 구성 type: <name>:<version>을(를) 제공해야 합니다. 서비스가 영구 스토리지를 사용하는 경우 디스크 값을 제공해야 합니다.

다음 형식을 사용하십시오.

<service-id>:
    type: <name>:<version>
    disk: <value-MB>

service-id

service-id 값은 프로젝트에서 서비스를 식별합니다. a에서 z까지, 0에서 9까지 영숫자만 사용할 수 있습니다(예: redis).

이 service-id 값은 .magento.app.yaml 구성 파일의 relationships 속성에 사용됩니다.

relationships:
    redis: "<name>:redis"

각 서비스 유형의 여러 인스턴스에 이름을 지정할 수 있습니다. 예를 들어 세션 인스턴스와 캐시 인스턴스 인스턴스를 여러 개 사용할 수 있습니다.

redis:
    type: redis:<version>

redis2:
    type: redis:<version>

services.yaml 파일의 서비스 이름을 바꾸면 영구적으로 제거 ​됩니다.

  • 지정한 새 이름으로 서비스를 만들기 전의 기존 서비스입니다.
  • 서비스에 대한 기존 데이터가 모두 제거됩니다. Adobe은 기존 서비스의 이름을 변경하기 전에 시작 환경을 백업할 것을 강력히 권장합니다.

type

type 값은 서비스 이름과 버전을 지정합니다. For example:

mysql:
    type: mysql:10.4

disk

disk 값은 서비스에 할당할 영구 디스크 저장소 크기(MB)를 지정합니다. MySQL과 같은 영구 저장소를 사용하는 서비스는 디스크 값을 제공해야 합니다. Redis와 같이 영구 저장소 대신 메모리를 사용하는 서비스에는 디스크 값이 필요하지 않습니다.

mysql:
    type: mysql:10.4
    disk: 5120

프로젝트당 현재 기본 스토리지 용량은 5GB 또는 512 0MB입니다. 이 금액을 애플리케이션과 각 서비스 간에 분배할 수 있습니다.

서비스 관계

클라우드 인프라 프로젝트의 Adobe Commerce에서 .magento.app.yaml 파일에 구성된 서비스 관계은(는) 애플리케이션에서 사용할 수 있는 서비스를 결정합니다.

$MAGENTO_CLOUD_RELATIONSHIPS 환경 변수에서 모든 서비스 관계에 대한 구성 데이터를 검색할 수 있습니다. 구성 데이터에는 포트 번호 및 로그인 자격 증명과 같은 필수 연결 세부 정보와 함께 서비스 이름, 유형 및 버전이 포함됩니다.

로컬 환경에서 관계를 확인하려면:

  1. 로컬 환경에서 활성 환경의 관계를 표시합니다.

    code language-bash 
    magento-cloud relationships

  2. 응답에서 service 및 type을(를) 확인합니다. 이 응답은 IP 주소 및 포트 번호와 같은 연결 정보를 제공합니다.

    축약된 샘플 응답

    code language-yaml 
    redis:
    -
...
        type: 'redis:7.0'
        port: 6379
elasticsearch:
    -
...
        type: 'opensearch:2'
        port: 9200
database:
    -
...
        type: 'mysql:10.6'
        port: 3306

원격 환경에서 관계를 확인하려면:

  1. SSH를 사용하여 원격 환경에 로그인합니다.

  2. 환경에 구성된 모든 서비스의 관계 구성 데이터를 나열합니다.

    code language-bash 
    echo $MAGENTO_CLOUD_RELATIONSHIPS | base64 -d | json_pp

    또는 다음 ece-tools 명령을 사용하여 관계를 봅니다.

    code language-bash 
    php ./vendor/bin/ece-tools env:config:show services

  3. 응답에서 service 및 type을(를) 확인합니다. 이 응답은 IP 주소 및 포트 번호와 필요한 사용자 이름 및 암호 자격 증명과 같은 연결 정보를 제공합니다.

서비스 버전

클라우드 인프라에서 Adobe Commerce에 대한 서비스 버전 및 호환성 지원은 클라우드 인프라에서 배포되고 테스트된 버전에 따라 결정되며 Adobe Commerce 온프레미스 배포에서 지원하는 버전과 다른 경우가 있습니다. Adobe이 특정 Adobe Commerce 및 Magento Open Source 릴리스에서 테스트한 타사 소프트웨어 종속성 목록은 설치 안내서의 시스템 요구 사항을 참조하십시오.

소프트웨어 EOL 확인

배포 프로세스 중에 ece-tools 패키지는 각 서비스의 EOL(서비스 종료) 날짜에 대해 설치된 서비스 버전을 확인합니다.

  • 서비스 버전이 EOL 날짜로부터 3개월 이내인 경우 배포 로그에 알림이 표시됩니다.
  • EOL 날짜가 과거인 경우 경고 알림이 표시됩니다.

저장소 보안을 유지하려면 설치된 소프트웨어 버전이 EOL에 도달하기 전에 업데이트하십시오. ece-tools' eol.yaml 파일에서 EOL 날짜를 검토할 수 있습니다.

OpenSearch로 마이그레이션

WARNING
Elasticsearch 7.11 이상 버전은 클라우드 인프라의 Adobe Commerce에서 지원되지 않습니다. Adobe Commerce 버전 2.3.7-p3, 2.4.3-p2 및 2.4.4 이상 버전은 OpenSearch 서비스를 지원합니다. 온-프레미스 설치는 Elasticsearch을 계속 지원합니다.

Adobe Commerce 버전 2.4.4 이상은 OpenSearch 서비스 설정을 참조하십시오.

서비스 버전 변경

설치된 서비스 버전을 업그레이드하여 클라우드 환경에 배포된 Adobe Commerce 버전과의 호환성을 유지할 수 있습니다.

설치된 서비스의 서비스 버전을 직접 다운그레이드할 수 없습니다. 그러나 필요한 버전으로 서비스를 만들 수는 있습니다. 다운그레이드 서비스 버전을 참조하세요.

설치된 서비스 버전 업그레이드

services.yaml 파일에서 서비스 구성을 업데이트하여 설치된 서비스 버전을 업그레이드할 수 있습니다.

  1. .magento/services.yaml 파일에서 서비스에 대한 type 값을 변경합니다.

    원래 서비스 정의

    code language-yaml 
    mysql:
    type: mysql:10.3
    disk: 2048

    업데이트된 서비스 정의

    code language-yaml 
    mysql:
    type: mysql:10.4
    disk: 5120

  2. 코드 변경 사항을 추가, 커밋 및 푸시합니다.

    code language-bash 
    git add .magento/services.yaml
    code language-bash 
    git commit -m "Upgrade MySQL from MariaDB 10.3 to 10.4."
    code language-bash 
    git push origin <branch-name>

다운그레이드 버전

설치된 서비스를 직접 다운그레이드할 수는 없습니다. 다음 두 가지 옵션이 있습니다.

  1. 기존 서비스의 이름을 새 버전으로 바꾸십시오. 새 버전으로 바꾸면 기존 서비스와 데이터가 제거되고 새 서비스가 추가됩니다.

  2. 서비스를 만들고 기존 서비스의 데이터를 저장합니다.

서비스 버전을 변경할 때는 services.yaml 파일에서 서비스 구성을 업데이트하고 .magento.app.yaml 파일에서 관계를 업데이트해야 합니다.

기존 서비스의 이름을 변경하여 서비스 버전을 다운그레이드하려면:

  1. .magento/services.yaml 파일에서 기존 서비스의 이름을 바꾸고 버전을 변경합니다.

    note warning
    WARNING
    기존 서비스의 이름을 바꾸면 기존 서비스가 바뀌고 모든 데이터가 삭제됩니다. 데이터를 유지해야 하는 경우 기존 서비스의 이름을 바꾸는 대신 서비스를 만듭니다.

    예를 들어 mysql 서비스에 대한 MariaDB 버전을 버전 10.4에서 10.3으로 다운그레이드하려면 기존 service-id 및 type 구성을 변경하십시오.

    원래 services.yaml 정의

    code language-yaml 
    mysql:
    type: mysql:10.4
    disk: 5120

    새 services.yaml 정의

    code language-yaml 
    mysql2:
     type: mysql:10.3
     disk: 5120

  2. .magento.app.yaml 파일의 관계를 업데이트합니다.

    원래 .magento.app.yaml 구성

    code language-yaml 
    relationships:
    database: "mysql:mysql"

    .magento.app.yaml 구성을 업데이트했습니다.

    code language-yaml 
    relationships:
    database: "mysql2:mysql"

  3. 코드 변경 사항을 추가, 커밋 및 푸시합니다.

서비스를 만들어 서비스를 다운그레이드하려면:

  1. 다운그레이드된 버전 사양으로 프로젝트의 services.yaml 파일에 서비스 정의를 추가합니다. 다음 예제에서는 mysql2 ​을(를) 참조하십시오.

    services.yaml

    code language-yaml 
    mysql:
    type: mysql:10.4
    disk: 5120
mysql2:
    type: mysql:10.3
    disk: 5120

  2. 새 서비스를 사용하려면 .magento.app.yaml 파일에서 관계 구성을 변경하십시오.

    원래 .magento.app.yaml 구성

    code language-yaml 
    relationships:
    database: "mysql:mysql"

    새 .magento.app.yaml 구성

    code language-yaml 
    relationships:
    database: "mysql2:mysql"

  3. 코드 변경 사항을 추가, 커밋 및 푸시합니다.

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