Cloud Docker 패키지
magento/magento-cloud-docker 패키지는 Adobe Commerce을 로컬 클라우드 환경에 배포하는 기능 및 도커 이미지를 제공합니다. 이 릴리스 노트는 Commerce용 Cloud Tools 제품군의 구성 요소인 이 패키지에 대한 최신 개선 사항을 설명합니다.
magento/magento-cloud-docker 패키지에서 다음 버전 시퀀스를 사용합니다. <major>.<minor>.<patch>
릴리스 노트는 다음과 같습니다.
-
새 기능 -
수정 사항 및 개선 사항
v1.4.5 latest
릴리스 날짜: 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.4—php-cli8.4 및php-fpm8.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일
-
개발자 모드 개선 워크플로—이전에는 빌드 및 배포 단계에서 모드를 지정해야 했습니다. 이제--mode단계의build옵션에 따라 이후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 개발자 환경에서 데이터 동기화에 대해 읽어 보십시오. -
up및down명령에서 볼륨 삭제 제거—--volume옵션이bin/magento-docker up및bin/magento-docker down명령에서 제거되었으며, 데이터 손실 경고가 있는 새bin/magento-docker init명령으로 대체되었습니다. 이 변경 사항은 우발적인 데이터 손실을 방지하는 데 도움이 됩니다. Joeshelton-wagento에서 제출함. -
생성된 인증서에 대한CN값을 업데이트했습니다—Dockerfile에서 하드코딩된CN값을 제거했습니다. 이 값으로 인해 인증서 오류(NET::ERR_CERT_INVALID)가 발생하여--host명령에 대한ece-docker build:compose옵션이 무시됩니다.
v1.2.2
릴리스 날짜: 2021년 4월 20일
-
플랫폼 독립적이 되도록host.docker.internal을 업데이트함—이제 Ubuntu, Windows 및 macOS에 대해 동일한 도커 작성 스크립트를 만들 수 있습니다. Ubuntu에서 Xdebug를 사용하는 경우 더 이상 별도의 환경 변수가 필요하지 않습니다. Igor Vitol이 제출한 수정 내용. -
init-docker.sh를 업데이트했습니다—mounts환경 변수에MAGENTO_CLOUD_APPLICATION개체를 추가했습니다. Chiranjeevi에서 수정 제출. -
init-docker.sh 업데이트—PHP 7.4 및 Cloud Docker 1.2.1 버전으로init-docker.sh스크립트를 업데이트했습니다. Adarsh Manickam에서 수정 제출. -
기본적으로 활성화된 나트륨—PHP 도커 이미지 내에서 기본적으로sodiumPHP 확장을 활성화했습니다. -
custom-registry옵션—고유한 이미지 레지스트리를 사용하기 위해--custom-registry명령에php ./vendor/bin/ece-docker build:compose옵션을 추가했습니다.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_timestampsPHP 설정을 사용하도록 설정했습니다. 이 설정을 사용하면 Docker에서 파일 시스템의 변경 사항이 인식되지 않는 문제가 해결되었습니다. -
수정build:custom:compose—빌드 프로세스 중에 파일을 덮어쓸 수 없을 때 오류가 발생하도록build:custom:compose명령을 수정했습니다. 오류가 발생하면docker-compose up에서 잘못된 파일을 사용하는 상황이 발생하지 않습니다. -
고정--sync_engine="native"옵션—프로덕션 모드(--mode="production")에서--sync_engine="native"옵션이docker.composer.yml파일에 로컬 폴더에 대한 항목을 만들지 않는 문제가 해결되었습니다. -
서비스 버전 유효성 검사 오류를 수정했습니다—RabbitMQ, Elasticsearch 및 기타 서비스에 대한 서비스 버전을type변수의MAGENTO_CLOUD_RELATIONSHIP속성에 추가했습니다. 이러한 버전을relationships변수에 추가하면 배포 단계에서 발생한 유효성 검사 오류가 해결되었습니다.
v1.2.1
릴리스 날짜: 2020년 12월 21일
-
NGINX 명령 옵션—TLS 및 웹 서비스에 대한 NGINXworker_processes및 NGINXworker_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-stempel및analysis-nori. 기본적으로analysis-icu및analysis-phonetic플러그인이 설치됩니다. 필요에 따라analysis-stempel및analysis-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--with-test명령에build:compose옵션을 추가하여 Docker 환경에서 테스트할 때만 컨테이너를 만들었습니다. 응용 프로그램 테스트.를 참조하세요. -
FPM-XDEBUG 컨테이너-
Linux에서 Xdebug 구성—Xdebug 컨테이너에서--set-docker-host값을 구성하기 위해ece-docker build:compose명령에host.docker.internal옵션을 추가했습니다. 이 옵션은 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가 중단될 수 있습니다.
-
사용자 지정 클라우드 도커 구성에서 사용자 지정 이미지 및 버전 지정—사용자 지정 도커 구성 파일(
build:custom:compose)을 생성할 때 사용자 지정 이미지 및 버전을 지정하는 옵션이 있는docker-compose.yaml명령을 업데이트했습니다. 사용자 지정 도커 구성 작성을 참조하십시오. -
모든 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-point및with-mariadb-conf옵션을 추가하여 데이터베이스 디렉터리를 탑재하도록 Cloud Docker 환경을 구성할 수 있습니다. 서비스 구성 옵션.을 참조하세요. -
CLI 명령 업데이트
./vendor/bin/ece-docker build:compose --db --with-entrypoint./vendor/bin/ece-docker build:compose --db --mariadb-confv1.1.0
릴리스 날짜: 2020년 6월 25일
-
분할 데이터베이스 성능 솔루션에 대한 지원이 추가됨—이제 Cloud Docker 환경에서 분할 데이터베이스 성능 솔루션을 사용하여 저장소를 구성하고 배포할 수 있습니다. -
Adobe Commerce 및 Magento Open Source 배포 지원—이제 Commerce용 Cloud Docker를 사용하여 클라우드 인프라의 Adobe Commerce에서 호스팅되지 않은 프로젝트에 대한 로컬 개발 환경을 배포할 수 있습니다. -
Blackfire.io 지원 - 자동화된 성능 테스트를 위해 Blackfire.io 확장을 사용할 수 있는 지원이 추가되었습니다. Zilker Technology에서 Adarsh Manickam이 제출한 수정 내용 -
컨테이너 업데이트-
Varnish - 이제 지원되는 버전의 클라우드 애플리케이션 템플릿을 사용하여 클라우드 도커 환경에서 Adobe Commerce을 배포할 때 Varnish가 기본 캐시가 됩니다. 바니시 컨테이너.를 참조하세요.
-
Cloud Docker 구성 파일을 생성할 때 Varnish 서비스 설치를 건너뛰는
--no-varnish옵션을 추가했습니다. -
데이터베이스 -
PHP-FPM-
PHP 7.4에 대한 지원이 추가되었습니다. Zilker Technology에서 Mohanela Murugan이 제출한 수정 내용
-
루트 프로젝트 디렉터리의
php.ini파일을 Cloud Docker 환경에 복사하고 사용자 지정 PHP 설정을 PHP-FPM 및 CLI 컨테이너에 적용하는 기능이 추가되었습니다. PHP 설정 사용자 지정을 참조하십시오. Zilker Technology에서 Mathew Beane이 제출한 수정 내용. -
컨테이너 상태 검사를 추가했습니다. Zilker Technology에서 Visanth Sampath가 제출한 수정 내용.
-
-
Node.js - 보안을 개선하기 위해 기본 Node.js 버전을 버전 8에서 버전 10으로 업데이트했습니다. Node.js 버전 8은 더 이상 사용되지 않으며 버그 수정 또는 보안 패치로 더 이상 업데이트되지 않습니다. Zilker Technology에서 Mohan Elamurugan이 제출한 수정 내용. -
Elasticsearch-
Elasticsearch 6.8, 7.2, 7.5 및 7.6.에 대한 지원이 추가되었습니다.
-
도커 구성 구성 파일을 생성할 때 Elasticsearch 컨테이너 구성을(를) 사용자 지정하는 기능이 추가되었습니다.
-
도커 작성 구성 파일을 생성하기 위한 서비스 구성 옵션에
--no-es옵션을 추가했습니다. 이 옵션을 사용하여 Elasticsearch 컨테이너 설치를 건너뛰고 대신 MySQL 검색을 사용하십시오. 이 옵션은 Adobe Commerce 버전 2.3.5 이하에서만 지원됩니다.
-
-
FPM-XDEBUG 컨테이너—Cloud Docker 환경에서 PHP를 디버깅하기 위해 Xdebug를 설치하고 구성하는 서비스 구성 옵션이 추가되었습니다. Xdebug 구성.을 참조하십시오.
-
-
Docker 구성 변경-
PHP-FPM, Redis, Elasticsearch 및 MySQL Docker 서비스 컨테이너에 대한 상태 검사를 추가했습니다.
-
개발자 모드에서 기본 파일 동기화 모드를
native(으)로 변경했습니다. -
docker-compose.yml파일을 생성할 때 일반 도커 서비스 컨테이너 이미지에 버전 정보를 추가했습니다. -
Nginx 서버의
fastcgi_buffers값을 늘려 업스트림 PHP-FPM 컨테이너에서 큰 응답을 처리하는 기능이 향상되었습니다. -
vendor디렉터리의 파일을 동기화하는 두 번째 동기화 세션을 추가하여 가변 파일 동기화 성능을 개선했습니다. 이 변경 사항으로 인해 파일 동기화 프로세스 중에 돌연변이가 중단되는 것을 방지할 수 있습니다. Zilker Technology에서 Mathew Beane이 제출한 수정 내용. -
CLI 명령 업데이트
-
bin/magento-docker flush-redisbin/magento-docker flush-varnish.vendor/bin/ece-docker build:compose --no-varnish.vendor/bin/ece-docker build:compose --es-env-var.vendor/bin/ece-docker build:compose --no-es./vendor/bin/ece-docker build:compose --db <mysql-version-number> --db-image mysql./vendor/bin/ece-docker build:compose --host=<hostname> --port=<port-number>.vendor/bin/ece-docker build:compose --mode developer --sync-engine native --with-xdebug