

지원 종료 알림: 2026년 5월 31일에에 대한 지원이 AWS 종료됩니다 AWS Panorama. 2026년 5월 31일 이후에는 AWS Panorama 콘솔 또는 AWS Panorama 리소스에 더 이상 액세스할 수 없습니다. 자세한 내용은 [AWS Panorama 지원 종료를 참조하세요](https://docs.aws.amazon.com/panorama/latest/dev/panorama-end-of-support.html).

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Windows에서 개발 환경 설정
<a name="applications-devenvwindows"></a>

AWS Panorama 애플리케이션을 빌드하려면 Docker, 명령줄 도구, Python을 사용합니다. Windows에서는 Linux 및 Ubuntu용 Windows Subsystem과 함께 Docker Desktop을 사용하여 개발 환경을 설정할 수 있습니다. 이 자습서에서는 AWS Panorama 도구 및 샘플 애플리케이션으로 테스트된 개발 환경의 설정 프로세스를 안내합니다.

**Topics**
+ [사전 조건](#applications-devenvwindows-prerequisites)
+ [WSL 2 및 Ubuntu 설치](#applications-devenvwindows-wsl2)
+ [Docker 설치](#applications-devenvwindows-docker)
+ [Ubuntu 구성](#applications-devenvwindows-ubuntu)
+ [다음 단계](#applications-devenvwindows-nextsteps)

## 사전 조건
<a name="applications-devenvwindows-prerequisites"></a>

이 자습서를 따르려면 Windows Subsystem for Linux 2(WSL 2)를 지원하는 Windows 버전이 필요합니다.

****
+ Windows 10 버전 1903 이상(빌드 18362 이상) 또는 Windows 11
+ Windows 기능
  + Windows Subsystem for Linux
  + Hyper-V
  + 가상 머신 플랫폼

이 자습서는 다음 소프트웨어 버전으로 개발되었습니다.

****
+ Ubuntu 20.04
+ Python 3.8.5
+ Docker 20.10.8

## WSL 2 및 Ubuntu 설치
<a name="applications-devenvwindows-wsl2"></a>

Windows 10 버전 2004 이상(빌드 19041 이상)을 사용하는 경우 다음 PowerShell 명령을 사용하여 WSL 2와 Ubuntu 20.04를 설치할 수 있습니다.

```
> wsl --install -d Ubuntu-20.04
```

이전 Windows 버전의 경우 WSL 2 설명서의 [이전 버전을 위한 수동 설치 단계](https://docs.microsoft.com/en-us/windows/wsl/install-manual) 지침을 따르십시오.

## Docker 설치
<a name="applications-devenvwindows-docker"></a>

Docker Desktop을 설치하려면 [hub.docker.com](https://hub.docker.com/editions/community/docker-ce-desktop-windows/)에서 설치 프로그램 패키지를 다운로드하여 실행하십시오. 문제가 발생하는 경우 Docker 웹 사이트 [Docker Desktop WSL 2 backend](https://docs.docker.com/desktop/windows/wsl/)의 지침을 따르십시오.

Docker Desktop을 실행하고 첫 실행 자습서에 따라 예시 컨테이너를 빌드하십시오.

**참고**  
Docker Desktop은 기본 배포에서만 Docker를 활성화합니다. 이 자습서를 실행하기 전에 다른 Linux 배포판을 설치한 경우 **리소스**, **WSL 통합**의 Docker Desktop 설정 메뉴에서 새로 설치한 Ubuntu 배포판에서 Docker를 활성화하십시오.

## Ubuntu 구성
<a name="applications-devenvwindows-ubuntu"></a>

이제 Ubuntu 가상 머신에서 Docker 명령을 실행할 수 있습니다. 명령줄 터미널을 열려면 시작 메뉴에서 배포를 실행하십시오. 처음 실행할 때는 관리자 명령을 실행하는 데 사용할 수 있는 사용자 이름과 암호를 구성합니다.

개발 환경 구성을 완료하려면 가상 컴퓨터의 소프트웨어를 업데이트하고 도구를 설치하십시오.

**가상 컴퓨터를 구성하려면**

1. Ubuntu와 함께 제공되는 소프트웨어를 업데이트하십시오.

   ```
   $ sudo apt update && sudo apt upgrade -y && sudo apt autoremove
   ```

1. apt를 사용하여 개발 도구를 설치합니다.

   ```
   $ sudo apt install unzip python3-pip
   ```

1. pip를 사용하여 Python 라이브러리를 설치합니다.

   ```
   $ pip3 install awscli panoramacli
   ```

1. 새 터미널을 열고 `aws configure`를 실행하여 AWS CLI를 구성합니다.

   ```
   $ aws configure
   ```

   액세스 키가 없는 경우 [IAM 콘솔](https://console.aws.amazon.com/iamv2/home?#/users)에서 생성할 수 있습니다.

마지막으로 샘플 애플리케이션을 다운로드하여 가져옵니다.

**샘플 애플리케이션을 가져오려면**

1. 샘플 애플리케이션을 다운로드하여 압축을 풉니다.

   ```
   $ wget https://github.com/awsdocs/aws-panorama-developer-guide/releases/download/v1.0-ga/aws-panorama-sample.zip
   $ unzip aws-panorama-sample.zip
   $ cd aws-panorama-sample
   ```

1. 포함된 스크립트를 실행하여 컴파일을 테스트하고, 애플리케이션 컨테이너를 구축하고, 패키지를 AWS Panorama에 업로드합니다.

   ```
   aws-panorama-sample$ ./0-test-compile.sh
   aws-panorama-sample$ ./1-create-role.sh
   aws-panorama-sample$ ./2-import-app.sh
   aws-panorama-sample$ ./3-build-container.sh
   aws-panorama-sample$ ./4-package-app.sh
   ```

AWS Panorama Application CLI는 패키지를 업로드하고 AWS Panorama 서비스에 등록합니다. 이제 AWS Panorama 콘솔로 [샘플 앱을 배포](gettingstarted-deploy.md#gettingstarted-deploy-deploy)할 수 있습니다.

## 다음 단계
<a name="applications-devenvwindows-nextsteps"></a>

프로젝트 파일을 탐색하고 편집하려면 파일 탐색기 또는 WSL을 지원하는 통합 개발 환경(IDE)을 사용할 수 있습니다.

가상 머신의 파일 시스템에 액세스하려면 파일 탐색기를 열고 탐색 표시줄에 `\\wsl$`를 입력합니다. 이 디렉토리에는 가상 머신의 파일 시스템(`Ubuntu-20.04`) 및 Docker 데이터의 파일 시스템에 대한 링크가 포함되어 있습니다. `Ubuntu-20.04` 아래의 `home\username`에 사용자 디렉토리가 있습니다.

**참고**  
Ubuntu 내에서 Windows 설치에 있는 파일에 액세스하려면 해당 `/mnt/c` 디렉토리로 이동하십시오. 예를 들어 `ls /mnt/c/Users/windows-username/Downloads`를 실행하여 다운로드 디렉토리의 파일을 나열할 수 있습니다.

Visual Studio Code를 사용하면 개발 환경에서 애플리케이션 코드를 편집하고 통합 터미널에서 명령을 실행할 수 있습니다. Visual Studio Code를 설치하려면 [code.visualstudio.com](https://code.visualstudio.com/)을 방문하십시오. 설치 후 [원격 WSL](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-wsl) 확장 프로그램을 추가합니다.

Windows 터미널은 명령을 실행하던 표준 Ubuntu 터미널의 대안입니다. 여러 탭을 지원하며 설치하는 다른 다양한 Linux에 대해 PowerShell, 명령 프롬프트 및 터미널을 실행할 수 있습니다.  Ctrl C  및  Ctrl V 를 사용한 복사 및 붙여넣기, 클릭 가능한 URL 및 기타 유용한 개선 사항을 지원합니다. Windows 터미널을 설치하려면 [microsoft.com](https://www.microsoft.com/en-us/p/windows-terminal/9n0dx20hk701)을 방문하십시오.