[PaaS만]{class="badge informative" title="Adobe Commerce 온 클라우드 프로젝트(Adobe 관리 PaaS 인프라) 및 온프레미스 프로젝트에만 적용됩니다."}

Cloud Docker 패키지

magento/magento-cloud-docker 패키지는 Adobe Commerce을 로컬 클라우드 환경에 배포하는 기능 및 도커 이미지를 제공합니다. 이 릴리스 노트는 Commerce용 Cloud Tools 제품군의 구성 요소인 이 패키지에 대한 최신 개선 사항을 설명합니다.

magento/magento-cloud-docker 패키지에서 다음 버전 시퀀스를 사용합니다. <major>.<minor>.<patch>

릴리스 노트는 다음과 같습니다.

  • 새 아이콘 새 기능
  • 수정 아이콘 수정 사항 및 개선 사항

v1.4.8 latest

릴리스 날짜: 2026년 5월 6일

  • 새 아이콘 업데이트된 서비스 테스트—MariaDB, RabbitMQ, ActiveMQ, Opensearch 및 Valkey에 대한 테스트가 업데이트되었습니다.
  • 새 아이콘 Valkey—Valkey 8.1 지원이 추가되었습니다.
  • 새 아이콘 Opensearch 이미지—Opensearch 2.19 및 3.5. 추가됨
  • 새 아이콘 ActiveMQ—ActiveMQ 2.51 지원이 추가되었습니다.
  • 새 아이콘 MariaDB—MariaDB 11.8 및 12.2 지원이 추가되었습니다.
  • 수정 아이콘 MailHog—MailHog 이미지를 수정했습니다.

v1.4.7

릴리스 날짜: 2026년 3월 5일

  • 새 아이콘 PHP 8.5—PHP 8.5에 대한 지원이 추가되었습니다.
  • 새 아이콘 추가 php-cliphp-fpm 8.5 이미지—PHP 8.5 지원을 통해 새 Cloud Docker 이미지(CLI 및 FPM)를 추가했습니다.
  • 새 아이콘 PHP 8.5 및 Opensearch 3.0 Docker 이미지 생성 명령이 추가됨-확인된 Docker 네트워크 격리(ARM64 포함), 통합 테스트를 수정하고 Docker 이미지 생성 명령에 대한 PHP 8.5 및 OpenSearch 3.0 지원을 추가했습니다.

v1.4.6

릴리스 날짜: 2025년 11월 13일

  • 수정 아이콘 Symfony 패키지 최신 Symfony YAML 패키지에 대한 지원이 추가되었습니다.

v1.4.5

릴리스 날짜: 2025년 10월 08일

  • 새 아이콘 ActiveMQ—기능 테스트로 cloud-docker에 ActiveMQ 지원이 추가되었습니다.

v1.4.4

릴리스 날짜: 2025년 8월 7일

  • 수정 아이콘 PHP 8.4—PHP 8.4 테스트를 추가했습니다.
  • 수정 아이콘 FTP 확장 - FTP 확장에 대한 수정 내용을 추가했습니다.
  • 새 아이콘 Opensearch3 이미지—Opensearch3에 대한 지원이 추가되었습니다.
  • 새 아이콘 Opensearch3 테스트—Opensearch3에 대한 PHP 8.4 테스트가 추가되었습니다.
  • 새 아이콘 Valkey—Valkey에 대한 지원이 추가되었습니다.

v1.4.3

릴리스 날짜: 2025년 6월 3일

  • 수정 아이콘 2.4.8과의 향상된 호환성-타사 라이브러리를 업데이트하여 2.4.8과의 더 나은 호환성

v1.4.2

릴리스 날짜: 2025년 4월 7일

  • 새 아이콘 PHP 8.4php-cli 8.4 및 php-fpm 8.4 이미지가 추가되었습니다.

v1.4.1

릴리스 날짜: 2025년 2월 6일

  • 새 아이콘 PHP 8.4—PHP 8.4에 대한 지원이 추가되었습니다.

v1.4.0

릴리스 날짜: 2024년 10월 7일

  • 수정 아이콘 리팩터링된 코드—이전 PHP 버전(7.4, 7.3, 7.2) 및 관련 라이브러리 및 이미지에 대한 지원이 제거되었습니다.

v1.3.7

릴리스 날짜: 2024년 4월 8일

  • 새 아이콘 PHP — PHP 8.3 및 PHP 8.3 이미지에 대한 지원을 추가했습니다.
  • 새 아이콘 Nginx — 이미지 nginx v를 추가했습니다. 1.24.
  • 새 아이콘 Opensearch - 이미지 OpenSearch v를 추가했습니다. 2.12, 1.3.
  • 새 아이콘 작성기 - 작성기 버전이 2.2.23으로 업데이트되었습니다.

v1.3.6

릴리스 날짜: 2023년 7월 31일

  • 새 아이콘 새 서비스 버전을 추가했습니다—OpenSearch 2.5.
  • 새 아이콘 작성기 캐시 사용—이제 Docker 컨테이너를 시작할 때 작성기 지우기 캐시를 사용하도록 Docker 구성을 확장할 수 있습니다. Commerce용 클라우드 도커 안내서에서 도커 구성 확장을 참조하십시오.

v1.3.5

릴리스 날짜: 2023년 3월 10일

  • 새 아이콘 ionCube—PHP 8.1 이미지에 대한 ionCube 확장을 추가했습니다.
  • 새 아이콘 새 서비스 버전 추가—OpenSearch 2.3 및 2.4, PHP 8.2, Varnish 7.1.1.
  • 새 아이콘 PHP 8.2.3에 대한 향상된 지원—Commerce 2.4.6을 지원하도록 특정 PHP 8.2.x 버전의 호환성 문제를 해결했습니다.
  • 수정 아이콘 작성기 문제—도커 컨테이너 내에서 작성기 버전을 업데이트한 후 발생한 문제를 해결했습니다.

v1.3.4

릴리스 날짜: 2022년 10월 27일

  • 새 아이콘 새 바니시 이미지 추가—바니시 6.5, 7.0, 7.1에 대한 이미지를 추가했습니다.

v1.3.3

릴리스 날짜: 2022년 9월 13일

  • 새 아이콘 Apple M1(ARM64) 지원—Apple M1(ARM64) 아키텍처에 대한 지원을 사용하도록 도커 이미지에 변경 내용을 추가했습니다.
  • 수정 아이콘 Mailhog—개발자 모드에 있는 동안 Mailhog 서비스가 이메일을 포착하지 못하는 문제를 해결했습니다.
  • 수정 아이콘 init-docker.sh - init-docker.sh 스크립트에서 서비스 버전 검사기를 수정했습니다.

v1.3.2

릴리스 날짜: 2022년 3월 31일

  • 새 아이콘 Elasticsearch 7.10 이미지 추가됨

v1.3.1

릴리스 날짜: 2022년 3월 10일

  • 새 아이콘 PHP 8.1 지원—PHP 8.1에 대한 지원이 추가되었습니다.

  • 새 아이콘 OpenSearch - OpenSearch 버전 1.1 및 1.2의 이미지를 추가했습니다.

  • 새 아이콘 작성기 2.1—PHP 8.x 이미지에서 기본적으로 작성기 2.1.x를 설정합니다.

  • 새 아이콘 PHP 이미지 개선

    • PHP 8.1 이미지가 추가되었습니다.
    • 업그레이드된 xDebug 버전 3.1.2
    • 업그레이드된 xmlrpc 1.0.0RC3
  • 수정 아이콘 Elasticsearch 및 OpenSearch 개선 사항—Elasticsearch 및 OpenSearch Dockerfiles의 개선 사항; Elasticsearch 5.2 이미지를 제거했습니다.

  • 수정 아이콘 나트륨 확장—모든 PHP 이미지에서 기본적으로 sodium 확장을 사용하도록 설정했습니다.

  • 수정 아이콘 작성기 캐시 볼륨 - 작성기 캐시 볼륨에 캐시된 작성기 패키지가 있는 경로가 수정되었습니다.

  • 수정 아이콘 nginx의 메모리 제한—NGINX 이미지의 메모리 제한이 수정되었습니다.

v1.3.0

릴리스 날짜: 2021년 10월 25일

  • 수정 아이콘 개발자 모드 개선 워크플로—이전에는 빌드 및 배포 단계에서 모드를 지정해야 했습니다. 이제 build 단계의 --mode 옵션에 따라 이후 deploy 단계의 모드가 결정됩니다. 배포 후 모드를 설정할 필요가 없습니다. 개발자 모드.

    보기

  • 수정 아이콘 읽기 전용 파일 시스템 개선 사항

    • 메일 구성에 대한 PHP 컨테이너를 시작하는 문제를 수정했습니다.
    • INI 파일에서 환경 변수를 사용할 수 있습니다.
    • PHP 진입점에 쓰기 권한이 필요하지 않은지 확인하십시오.
  • 수정 아이콘 노드 업데이트—번들 노드 버전을 업데이트합니다. PHP-CLI 이미지에 노드를 설치할 때 현재 LTS 버전을 사용합니다.

  • 수정 아이콘 Symfony 업데이트—Adobe Commerce 2.4.4와 호환되도록 Symfony 구성 종속성을 업데이트했습니다.

v1.2.4

릴리스 날짜: 2021년 7월 29일

  • 새 아이콘 Zookeeper 컨테이너—Cloud Infrastructure의 Adobe Commerce에 배포되지 않은 프로젝트에 대한 잠금 공급자 구성을 관리하기 위해 Zookeeper 컨테이너를 추가했습니다.

  • 새 아이콘 Composer 2.0에 대한 지원이 추가되었습니다.—수명이 다되어 가는 Composer 1.0에서 업그레이드를 지원하도록 Composer 버전 2.0을 Composer 구성 파일에 추가했습니다.

v1.2.3

릴리스 날짜: 2021년 6월 14일

  • 새 아이콘 PHP 8.0 추가—PHP를 버전 8.0으로 업데이트하여 PHP 8.0에 포함된 모든 새로운 기능과 최적화를 활용할 수 있습니다.
  • 새 아이콘 Varnish 6.6 및 Elasticsearch 7.11.2(으)로 업데이트됨—다음 링크는 Varnish Cache 6.6 및 Elasticsearch 7.11.2. 에 대한 릴리스 정보를 제공합니다.
  • 새 아이콘 PHP 7.4 이미지용 ioncube 확장 추가—PHP 7.3에서 PHP 7.4로 업그레이드하는 동안 처음 제외되었던 ioncube 확장이 PHP 7.4 이미지에 다시 추가되었습니다. mattskr에서 제출함.
  • 새 아이콘 파일 동기화 옵션 추가:manual-native - manual-native 파일 동기화 옵션은 수동으로 동기화를 제어하므로 macOS 및 Windows 환경에 최상의 성능을 제공합니다. 개발자 모드에서 manual-native 옵션을 사용하는 방법과 Docker 개발자 환경에서 데이터 동기화에 대해 읽어 보십시오.
  • 새 아이콘 updown 명령에서 볼륨 삭제 제거--volume 옵션이 bin/magento-docker upbin/magento-docker down 명령에서 제거되었으며, 데이터 손실 경고가 있는 새 bin/magento-docker init 명령으로 대체되었습니다. 이 변경 사항은 우발적인 데이터 손실을 방지하는 데 도움이 됩니다. Joeshelton-wagento에서 제출함.
  • 고정 아이콘 생성된 인증서에 대한 CN 값을 업데이트했습니다—Dockerfile에서 하드코딩된 CN 값을 제거했습니다. 이 값으로 인해 인증서 오류(NET::ERR_CERT_INVALID)가 발생하여 ece-docker build:compose 명령에 대한 --host 옵션이 무시됩니다.

v1.2.2

릴리스 날짜: 2021년 4월 20일

  • 새 아이콘 플랫폼 독립적이 되도록 host.docker.internal을 업데이트함—이제 Ubuntu, Windows 및 macOS에 대해 동일한 도커 작성 스크립트를 만들 수 있습니다. Ubuntu에서 Xdebug를 사용하는 경우 더 이상 별도의 환경 변수가 필요하지 않습니다. Igor Vitol이 제출한 수정 내용.

  • 새 아이콘 init-docker.sh를 업데이트했습니다MAGENTO_CLOUD_APPLICATION 환경 변수에 mounts 개체를 추가했습니다. Chiranjeevi에서 수정 제출.

  • 새 아이콘 init-docker.sh 업데이트—PHP 7.4 및 Cloud Docker 1.2.1 버전으로 init-docker.sh 스크립트를 업데이트했습니다. Adarsh Manickam에서 수정 제출.

  • 새 아이콘 기본적으로 활성화된 나트륨—PHP 도커 이미지 내에서 기본적으로 sodium PHP 확장을 활성화했습니다.

  • 새 아이콘 custom-registry옵션—고유한 이미지 레지스트리를 사용하기 위해 php ./vendor/bin/ece-docker build:compose 명령에 --custom-registry 옵션을 추가했습니다.

    code language-bash
    ./vendor/bin/ece-docker build:compose --custom-registry=my-registry.example.com
    
  • 새 아이콘 이전 Elasticsearch 버전을 제거—Elasticsearch 이미지에서 Elasticsearch 버전 1.7 및 2.4를 제거했습니다.

  • 새 아이콘 NGINX 인증서 자동 생성—NGINX 이미지에서 기존 인증서를 제거했습니다. 이제 NGINX 인증서가 보안 향상을 위해 새 배포마다 자동으로 생성됩니다.

  • 수정 아이콘 사용opcache.validate_timestamps—개발자 모드에서 기본적으로 opcache.validate_timestamps PHP 설정을 사용하도록 설정했습니다. 이 설정을 사용하면 Docker에서 파일 시스템의 변경 사항이 인식되지 않는 문제가 해결되었습니다.

  • 수정 아이콘 수정build:custom:compose—빌드 프로세스 중에 파일을 덮어쓸 수 없을 때 오류가 발생하도록 build:custom:compose 명령을 수정했습니다. 오류가 발생하면 docker-compose up에서 잘못된 파일을 사용하는 상황이 발생하지 않습니다.

  • 수정 아이콘 고정 --sync_engine="native" 옵션—프로덕션 모드(--mode="production")에서 --sync_engine="native" 옵션이 docker.composer.yml 파일에 로컬 폴더에 대한 항목을 만들지 않는 문제가 해결되었습니다.

  • 수정 아이콘 서비스 버전 유효성 검사 오류를 수정했습니다—RabbitMQ, Elasticsearch 및 기타 서비스에 대한 서비스 버전을 MAGENTO_CLOUD_RELATIONSHIP 변수의 type 속성에 추가했습니다. 이러한 버전을 relationships 변수에 추가하면 배포 단계에서 발생한 유효성 검사 오류가 해결되었습니다.

v1.2.1

릴리스 날짜: 2020년 12월 21일

  • 새 아이콘 NGINX 명령 옵션—TLS 및 웹 서비스에 대한 NGINX worker_processes 및 NGINX worker_connections의 수를 변경하는 빌드 명령 옵션을 추가했습니다. worker_process 매개 변수는 값을 auto(으)로 설정하는 기능을 유지합니다. 예:

    code language-bash
    ./vendor/bin/ece-docker build:compose --nginx-worker-processes=2
    ./vendor/bin/ece-docker build:compose --nginx-worker-connections=2048
    
  • 새 아이콘 TLS 명령 옵션—TLS 서비스 없이 구성을 만드는 빌드 명령 옵션을 추가했습니다. 예:

    code language-bash
    ./vendor/bin/ece-docker build:compose --no-tls
    
  • 새 아이콘 NGINX 메모리 사용량—TLS 및 웹 서비스에 대한 NGINX 프로세스에서 사용하는 메모리가 감소했습니다.

  • 새 아이콘 Blackfire—Cloud Docker 이미지에서 기본적으로 Blackfire PHP 확장을 사용하지 않도록 설정했습니다.

  • 수정 아이콘 PHP-FPM 컨테이너WEB_PORT을(를) 80에서 8080(으)로 변경하여 PHP-FPM 컨테이너 상태 검사를 수정했습니다.

  • 수정 아이콘 잘못된 볼륨 이름 지정—개발자 모드에서 잘못된 볼륨 이름 지정으로 오류를 해결했습니다.

  • 수정 아이콘 NGINX 업스트림 포트—무한 루프를 방지하기 위해 포트 8080을 사용하도록 도커 NGINX 1.19 이미지를 업데이트했습니다. Adarsh Manickam에서 수정 제출.

v1.2.0

릴리스 날짜: 2020년 11월 9일

  • 새 아이콘 컨테이너 업데이트—

    • 새 아이콘 PHP-FPM 컨테이너—gnupg PHP 확장에 대한 지원을 추가했습니다. Zilker Technology에서 G Arvind가 제출한 수정 사항.

    • 수정 아이콘 데이터베이스 컨테이너—상태 검사 명령에 필요한 데이터베이스 암호를 추가하여 데이터베이스 컨테이너 상태 검사를 해결했습니다.

    • 새 아이콘 Elasticsearch 컨테이너

      • 예정된 Adobe Commerce 릴리스와의 호환성을 위해 Elasticsearch 7.9에 대한 지원이 추가되었습니다.

      • Elasticsearch 플러그 인 구성 - services.yaml 파일의 Elasticsearch 플러그 인 구성 정보를 사용하여 Commerce 환경용 Cloud Docker의 docker-compose.yaml 파일을 생성하는 지원이 추가되었습니다. Elasticsearch 플러그인.을 참조하세요.

      • Elasticsearch 플러그인 지원—다음 Elasticsearch 플러그인에 대한 지원이 추가되었습니다. analysis-icu, analysis-phonetic, analysis-stempelanalysis-nori. 기본적으로 analysis-icuanalysis-phonetic 플러그인이 설치됩니다. 필요에 따라 analysis-stempelanalysis-nori 플러그인을 추가하거나 제거할 수 있습니다.

    • 새 아이콘 CLI 컨테이너

      • Docker PHP 컨테이너 내에서 명령 실행—이제 Cloud Docker CLI를 사용하여 호스트에 PHP를 설치하지 않고도 Docker 환경의 PHP 컨테이너 내에서 명령을 실행할 수 있습니다. 예를 들어 ./bin/magento-docker php 7.3 vendor/bin/ece-docker build:compose 명령은 구성을 빌드합니다. Cloud Docker CLI를 참조하십시오. Zilker Technology에서 G Arvind가 제출한 수정 사항.

      • PHP CLI 컨테이너에 OpenSSH-client를 추가했습니다. 이제 composer.json 파일에 Composer 명령을 사용하기 위해 ssh 클라이언트가 필요한 개인 git 저장소가 포함된 경우 Composer에 대해 ssh 에이전트 전달을 사용할 수 있습니다.

    • 수정 아이콘 TLS 컨테이너—이제 TLS 컨테이너은(는) CentOS 이미지 대신 https://hub.docker.com/r/magento/magento-cloud-docker-nginx 도커 이미지를 기반으로 합니다. 이 변경 사항은 Cloud Docker 환경의 컨테이너 간에 HTTPS 요청을 보낼 때 오류가 발생하는 문제를 해결합니다.

    • 새 아이콘 테스트 컨테이너—응용 프로그램 테스트를 위한 테스트 컨테이너를 추가하고 Docker build:compose 명령에 --with-test 옵션을 추가하여 Docker 환경에서 테스트할 때만 컨테이너를 만들었습니다. 응용 프로그램 테스트.를 참조하세요.

    • 새 아이콘 FPM-XDEBUG 컨테이너

      • 새 아이콘 Linux에서 Xdebug 구성—Xdebug 컨테이너에서 host.docker.internal 값을 구성하기 위해 ece-docker build:compose 명령에 --set-docker-host 옵션을 추가했습니다. 이 옵션은 Linux 시스템에서 Xdebug를 사용하는 데 필요합니다. Docker용 Xdebug 구성을 참조하십시오.

      • 수정 아이콘 로그에서 uninitialized "with_xdebug" variable 오류를 해결하기 위해 도커 진입점에 대한 Xdebug 변수 구성을 수정했습니다. Florent Olivaud에서 제출한 수정 사항

  • 새 아이콘 Docker 구성 변경

    • MailHog 구성—이제 ece-docker build:compose 명령 옵션을 사용하여 MailHog를 사용하지 않도록 설정하고 포트를 지정할 수 있습니다. --no-mailhog, --mailhog-http-port--mailhog-smtp-port. 전자 메일 설정.을 참조하세요.

    • Commerce 1.2.0 이상용 Cloud Docker의 경우, 이제 Adobe에서 각 패치 버전에 대한 Docker 이미지를 제공하며, Docker 구성 생성기가 최신 버전을 사용하는 대신 지정된 패치 버전으로 Docker 구성을 생성합니다. 이전에는 도커 구성 생성기가 최신 패치 버전을 사용하여 구성을 빌드했습니다. 이로 인해 이전 버전을 사용하여 빌드된 Commerce 환경용 Cloud Docker가 중단될 수 있습니다.

    • 사용자 지정 클라우드 도커 구성에서 사용자 지정 이미지 및 버전 지정—사용자 지정 도커 구성 파일(docker-compose.yaml)을 생성할 때 사용자 지정 이미지 및 버전을 지정하는 옵션이 있는 build:custom:compose 명령을 업데이트했습니다. 사용자 지정 도커 구성 작성을 참조하십시오.

    • 모든 CLI 컨테이너에서 Adobe Commerce(https://magento2.docker)에 액세스할 수 있도록 포트 443을 표시하도록 도커 호스트 구성을 업데이트했습니다. 도커 구성 파일을 생성할 때 --tls-port 옵션을 추가하여 기본 포트를 변경할 수 있습니다.

  • 수정 아이콘 app/etc/env.php 파일이 있는 경우 Commerce용 Cloud Docker 빌드가 실패하는 문제를 해결했습니다.

  • 수정 아이콘 Linux에서 Commerce용 Cloud Docker 또는 Linux용 Windows 하위 시스템(WSL2)을 배포할 때 문제를 방지하기 위해 이름이 지정된 볼륨을 일반 볼륨으로 바꾸도록 빌드 구성을 업데이트했습니다.

  • 수정 아이콘 작성기 2.0을 지원하도록 Commerce 기능 테스트용 Cloud Docker를 업데이트했습니다.

v1.1.2

릴리스 날짜: 2020년 9월 9일

  • 새 아이콘 Elasticsearch 7.7에 대한 지원이 추가됨

v1.1.1

릴리스 날짜: 2020년 8월 5일

  • 수정 아이콘 이메일 구성을 업데이트했습니다—SendMail을 사용하는 대신 MailHog 서비스를 지원하도록 Commerce용 기본 Cloud Docker 구성을 업데이트했습니다. 전자 메일 설정.을 참조하세요.

  • 수정 아이콘 ps: command not found 오류를 해결하기 위해 PS 라이브러리를 Cloud Docker 환경 구성으로 복원했습니다.

  • 수정 아이콘 Cloud Docker 환경을 시작할 때 발생할 수 있는 Cannot create container for service db 오류를 수정하기 위해 데이터베이스 진입점 및 MariaDB 볼륨의 자동 마운트를 제거하도록 Commerce용 기본 Cloud Docker 구성을 업데이트했습니다.

    이제 ece-docker build:compose 명령에 --with-entry-pointwith-mariadb-conf 옵션을 추가하여 데이터베이스 디렉터리를 탑재하도록 Cloud Docker 환경을 구성할 수 있습니다. 서비스 구성 옵션.을 참조하세요.

  • 새 아이콘 CLI 명령 업데이트

액션
명령
데이터베이스 컨테이너에 진입점을 추가하여 백업에서 데이터베이스를 복원합니다.
./vendor/bin/ece-docker build:compose --db --with-entrypoint
MariaDB 구성 볼륨 추가
./vendor/bin/ece-docker build:compose --db --mariadb-conf

v1.1.0

릴리스 날짜: 2020년 6월 25일

7c2b03ac-000c-497d-aba3-2c6dc720a938