기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# AWS SAMCLI와 함께 사용할 Docker 설치
Docker은 컴퓨터에서 컨테이너를 실행하는 애플리케이션입니다. 를 사용하면와 유사한 로컬 환경을 컨테이너 AWS Lambda 로 Docker AWS SAM 제공하여 서버리스 애플리케이션을 빌드, 테스트 및 디버깅할 수 있습니다.
**참고**
Docker은 애플리케이션을 로컬에서 테스트하고 `--use-container` 옵션을 사용하여 배포 패키지를 구축하는 경우에만 필요합니다.
**Topics**
+ [Docker 설치하기](#install-docker-instructions)
+ [다음 단계](#install-docker-next-steps)
## Docker 설치하기
Docker을 운영 체제 상에 설치하려면 이 지침을 따르십시오.
### Linux
Docker는 CentOS, Debian, Ubuntu등 최신 Linux 배포 버전을 비롯하여 많은 서로 다른 운영 체제에서 사용할 수 있습니다. 특정 운영 체제에 Docker를 설치하는 방법에 대한 자세한 내용은 Docker Docs 웹사이트에서 [Get Docker](https://docs.docker.com/get-docker/)를 잠조하세요.
**Amazon Linux 2 또는 Amazon Linux 2023 상에 Docker을 설치하기**
1. 인스턴스에 설치한 패키지 및 패키지 캐시를 업데이트합니다.
```
$ sudo yum update -y
```
1. 최신 Docker Community Edition 패키지를 설치합니다.
+ Amazon Linux 2의 경우 다음을 실행합니다.
```
$ sudo amazon-linux-extras install docker
```
+ Amazon Linux 2023의 경우 다음을 실행합니다.
```
$ sudo yum install -y docker
```
1. Docker 서비스를 시작합니다.
```
$ sudo service docker start
```
1. `ec2-user`를 사용하지 않고도 `docker` 명령을 실행할 수 있도록 Docker 그룹에 **sudo**를 추가합니다.
```
$ sudo usermod -a -G docker ec2-user
```
1. 로그아웃 후 다시 로그인해서 새 `docker` 그룹 권한을 취득합니다. 이를 위해 현재 SSH 터미널 창을 닫고 새 창에서 인스턴스를 다시 연결할 수 있습니다. 새 SSH 세션은 적절한 `docker` 그룹 권한을 가져야 합니다.
1. `ec2-user` 없이도 **sudo**가 Docker 명령을 실행할 수 있는지 확인합니다.
```
$ docker ps
```
다음과 같은 출력결과를 보고 Docker가 설치 및 실행 중임을 확인할 수 있어야 합니다.
```
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
```
**참고**
Linux에서 호스트 머신과 다른 명령 세트 아키텍처로 Lambda 함수를 빌드하고 실행하려면 추가로 Docker을 구성하는 단계가 있습니다. 예를 들어, `arm64` 기기에서 `x86_64` 함수를 실행하려면 다음 Docker 명령을 실행하여 `docker run --rm --privileged multiarch/qemu-user-static --reset -p yes` 대몬을 구성할 수 있습니다.
Docker의 설치에 문제가 발생하면 [설치 오류 문제 해결](install-sam-cli.md#sam-cli-troubleshoot-install)을 잠조하세요. 또는 Docker Docs 웹 사이트에서 [Linux용 사후 설치 단계](https://docs.docker.com/engine/install/linux-postinstall/#troubleshooting)의 **문제 해결** 섹션을 잠조하세요.
### macOS
**참고**
Docker 데스크톱은 공식적으로 지원되지만 AWS SAMCLI 버전 1.47.0부터는 Docker 런타임을 사용하는 경우 대체 버전을 사용할 수 있습니다.
1. Docker 설치
AWS SAMCLI는 macOS Sierra 10.12 이상에서 Docker 실행을 지원할 수 있습니다. Docker의 설치 방법은 [Docs 웹 사이트에서 DockerMac용](https://docs.docker.com/docker-for-mac/install/) 데스크톱 Docker 설치를 잠조하세요.
1. 공유 드라이브 구성
를 AWS SAM CLI 사용하려면 프로젝트 디렉터리 또는 상위 디렉터리가 공유 드라이브에 나열되어야 합니다. 이 경우 파일 공유가 필요할 수 있습니다. 자세한 내용은 [ 문서](https://docs.docker.com/desktop/troubleshoot-and-support/troubleshoot/topics/#volume-mounting-requires-file-sharing-for-any-project-directories-outside-of-home)의 *Docker볼륨 마운팅에 필요한 파일 공유* 문제 해결 항목을 잠조하세요.
1. 설치 확인
Docker을 설치한 후 제대로 작동하는지 확인하십시오. 또한 명령줄에서 Docker 명령을 실행할 수 있는지 확인하십시오(예: `docker ps`). 컨테이너를 설치하거나 가져오거나 가져올 필요가 없습니다. 필요에 따라 AWS SAMCLI가 자동으로 이 작업을 수행합니다.
Docker의 설치 문제가 발생하는 경우 추가 문제 해결 팁은 [Docs 웹 사이트](https://docs.docker.com/docker-for-mac/troubleshoot/)의 Docker 문제 해결 및 진단 섹션을 잠조하세요.
### Windows
**참고**
AWS SAM 는 공식적으로 Docker 데스크톱을 지원합니다. 그러나 AWS SAMCLI 버전 1.47.0부터는 Docker 런타임을 사용하는 한 대체 제품을 사용할 수 있습니다.
1. Docker을 설치합니다.
Docker 데스크톱은 최신 Windows 운영 체제를 지원합니다. 레거시 버전의 Windows의 경우 Docker Toolbox를 사용할 수 있습니다. 올바른 Docker 설치 단계를 위해 사용 중인 Windows 버전을 선택하십시오.
+ Docker을 [ Windows 10용으로 설치하려면 Docker Docs 웹 사이트](https://docs.docker.com/docker-for-windows/install/)에서 Docker Windows용 데스크톱 설치를 잠조하세요.
+ Docker을 이전 버전의 Windows용으로 설치하려면 [ Toolbox GitHubDocker 리포지토리](https://github.com/docker-archive/toolbox)의 DockerToolbox를 잠조하세요.
1. 공유 드라이브를 구성하십시오.
를 AWS SAM CLI 사용하려면 프로젝트 디렉터리 또는 상위 디렉터리가 공유 드라이브에 나열되어야 합니다. 경우에 따라 Docker이 제대로 작동하게 하려면 드라이브를 공유해야 합니다.
1. 설치를 확인합니다.
Docker을 설치한 후 제대로 작동하는지 확인하십시오. 또한 명령줄에서 Docker 명령을 실행할 수 있는지 확인하십시오(예: **docker ps**). 컨테이너를 설치하거나 가져오거나 가져올 필요가 없습니다. 필요에 따라 AWS SAMCLI가 자동으로 이 작업을 수행합니다.
Docker의 설치 문제가 발생하는 경우 추가 문제 해결 팁은 [Docs 웹 사이트](https://docs.docker.com/docker-for-mac/troubleshoot/)의 Docker 문제 해결 및 진단 섹션을 잠조하세요.
## 다음 단계
를 설치하는 방법은 단원을 AWS SAM CLI참조하십시오[AWS SAM CLI 설치](install-sam-cli.md).