AWS EC2 인스턴스를 만들 때, OS를 아마존에서 제공하는 AL2023으로 만드는 경우가 있습니다.
이 경우 docker는 설치가 잘 되지만, docker-compose의 설치가 실패하는 경우가 있습니다.
이를 해결하고 원인을 확인해 봅시다.

설치 방법 요약

$ sudo yum update
$ sudo yum install docker -y
$ sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
$ sudo yum install docker-compose-plugin -y --releasever=7

1. docker-compose 설치 문서 읽기

먼저 도커 홈페이지의 Docker Compose: Install using the repository를 읽어봅니다.

$ sudo yum update
$ sudo yum install docker-compose-plugin

오 간단하네요. 하지만 직접 해보면 에러가 납니다.

$ sudo yum install docker-compose-plugin
Last metadata expiration check: 0:38:42 ago on Wed Oct 22 01:51:59 2025.
No match for argument: docker-compose-plugin
Error: Unable to find a match: docker-compose-plugin

2. repo 추가

AL2023에 기본으로 설정되어 있는 yum.repos.d에는 docker-compose 패키지가 없습니다.
그래서 docker-compose-plugin 설치시 Unable to find a match 에러가 발생합니다.

$ cd /etc/yum.repos.d/
$ grep . *
amazonlinux.repo:[amazonlinux]
amazonlinux.repo:name=Amazon Linux 2023 repository
amazonlinux.repo:mirrorlist=https://al2023-repos-$awsregion-de612dc2.s3$dualstak.$awsregion.$awsdomain/core/mirrors/$releasever/$basearch/$mirrorlist
# 중략
kernel-livepatch.repo:[kernel-livepatch]
kernel-livepatch.repo:name=Amazon Linux 2023 Kernel Livepatch repository
kernel-livepatch.repo:mirrorlist=https://al2023-repos-$awsregion-de612dc2.s3.dulstack.$awsregion.$awsdomain/kernel-livepatch/mirrors/al2023/$basearch/mirror.lst
# 중략

도커 홈페이지의 Docker Engine: Install using the rpm repository를 참고하여 docker의 repo를 추가해줍니다.

$ sudo dnf -y install dnf-plugins-core
$ sudo dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo

3. releasever 설정하기

하지만 이번에는 Cannot download repomd.xml 에러가 발생합니다.

$ sudo yum install docker-compose-plugin
Docker CE Stable - x86_64                       382  B/s | 397  B     00:01    
Errors during downloading metadata for repository 'docker-ce-stable':
  - Status code: 404 for https://download.docker.com/linux/centos/2023.9.20251014/x86_64/stable/repodata/repomd.xml (IP: 18.244.60.57)
Error: Failed to download metadata for repo 'docker-ce-stable': Cannot download repomd.xml: Cannot download repodata/repomd.xml: All mirrors were tried
Ignoring repositories: docker-ce-stable
Last metadata expiration check: 1:26:00 ago on Wed Oct 22 01:51:59 2025.
No match for argument: docker-compose-plugin
Error: Unable to find a match: docker-compose-plugin

실제로 위의 URL로 직접 접근해보면 마찬가지로 404가 발생합니다.
아까 추가한 docker의 repo를 확인해봅시다.

$ cat /etc/yum.repos.d/docker-ce.repo 
[docker-ce-stable]
name=Docker CE Stable - $basearch
baseurl=https://download.docker.com/linux/centos/$releasever/$basearch/stable
# 후략

$releasever가 2023.9.20251014라는 값으로 되어 있나봅니다.
하지만 CentOS에는 이런 $releasever는 없습니다. 7이나 8 등등이죠. 왜 이렇게 된 걸까요?

실은 AL2023은 여러 패키지를 아마존 자신들이 직접 관리합니다.
Amazon Linux 2023: Package support statements
그래서 이를 위해 다른 repo와 호환되지 않는 $releasever으로 직접 관리하고 있습니다.

유효한 releasever는 최신 버전이거나 2023.8.20250908과 같은 날짜 스탬프 버전입니다.

이제 --releasever 옵션을 통해 명시적으로 버젼을 설정하여 AL2023 외부의 repo에서 패키지를 설치할 수 있습니다.

$ sudo yum install docker-compose-plugin -y --releasever=7

혹은 docker-ce.repo를 직접 수정할 수도 있습니다.

$ sudo yum-config-manager --setopt="docker-ce-stable.baseurl=https://download.docker.com/linux/centos/7/\$basearch/stable" --save
$ cat /etc/yum.repos.d/docker-ce.repo 
[docker-ce-stable]
name=Docker CE Stable - $basearch
baseurl=https://download.docker.com/linux/centos/7/$basearch/stable
# 후략

4. 설치 완료

$ sudo yum install docker-compose-plugin -y --releasever=7
Amazon Linux 2023 repository                    1.9 kB/s | 275  B     00:00    
Errors during downloading metadata for repository 'amazonlinux':
  - Status code: 403 for https://al2023-repos-ap-northeast-2-de612dc2.s3.dualstack.ap-northeast-2.amazonaws.com/core/mirrors/7/x86_64/mirror.list (IP: 3.5.188.25)
  - Status code: 403 for https://al2023-repos-ap-northeast-2-de612dc2.s3.dualstack.ap-northeast-2.amazonaws.com/core/mirrors/7/x86_64/mirror.list (IP: 3.5.188.176)
Error: Failed to download metadata for repo 'amazonlinux': Cannot prepare internal mirrorlist: Status code: 403 for https://al2023-repos-ap-northeast-2-de612dc2.s3.dualstack.ap-northeast-2.amazonaws.com/core/mirrors/7/x86_64/mirror.list (IP: 3.5.188.176)
Docker CE Stable - x86_64                       192 kB/s | 3.5 kB     00:00    
Ignoring repositories: amazonlinux
Dependencies resolved.
================================================================================
 Package                  Arch      Version           Repository           Size
================================================================================
Installing:
 docker-compose-plugin    x86_64    2.27.1-1.el7      docker-ce-stable     13 M

# 중략

Installed:
  docker-compose-plugin-2.27.1-1.el7.x86_64                                     

Complete!
$ docker compose version
Docker Compose version v2.27.1

정상적으로 설치가 완료 되었습니다.
이렇게 AL2023에서 yum으로 docker-compose를 설치해보고, 설치가 실패하는 원인을 확인해 보았습니다.