이 빠른 시작에서는 Azure 개발자 CLI(azd) 템플릿Azure에 앱 리소스를 프로비전하고 배포하는 방법을 알아봅니다.
azd 템플릿은 Azure 리소스를 프로비전하는 구성 및 인프라 파일뿐만 azd 아니라 애플리케이션 소스 코드를 포함하는 표준 코드 리포지토리입니다. 템플릿 및 Azure 프로비저닝 및 배포 프로세스를 가속화하는 방법에 대한 azd 자세한 내용은 Azure 개발자 CLI 템플릿이란?을 참조하세요.
템플릿 선택 및 배포
다음 단계를 수행하려면 다음 템플릿을 사용하여 Azure에서 앱을 프로비전하고 배포합니다.
Awesome AZD 템플릿 갤러리 사이트에서 기본 설정과 일치하는 템플릿을 선택할 수도 있습니다. 사용하는 템플릿에 관계없이 개발 환경에서 템플릿 코드로 끝나고 명령을 실행하여 Azure에서 앱을 빌드, 재배포 및 모니터링할 수 있습니다.
계속하려면 원하는 환경을 선택합니다.
로컬 개발 환경은 기존 개발 워크플로에 적합합니다. 템플릿 리포지토리를 디바이스에 복제하고 로컬 설치 azd에 대해 명령을 실행합니다.
필수 조건
프로젝트 초기화
파일 탐색기 또는 터미널에서 빈 디렉터리를 새로 만들고 해당 디렉터리로 변경합니다.
azd init 명령을 실행하고 매개 변수로 사용할 템플릿을 지정합니다.
azd init --template todo-nodejs-mongo
azd init --template todo-python-mongo
azd init --template todo-csharp-cosmos-sql
azd init --template todo-java-mongo-aca
메시지가 표시되면 환경 이름을 입력합니다(예: azdquickstartAzure 리소스를 보유하기 위해 만들 리소스 그룹에 대한 이름 지정 접두사 설정).
환경 이름이 azd란?
환경을 azd 지정한 후 템플릿 프로젝트를 컴퓨터에 복제하고 프로젝트를 초기화합니다.
앱 리소스 프로비전 및 배포
azd auth login 명령을 azd 실행하고 로그인 프로세스를 완료할 수 있도록 브라우저를 시작합니다.
azd auth login
azd up 명령을 실행합니다.
azd up
Azure에 로그인하면 다음 정보를 입력하라는 메시지가 표시됩니다.
| 매개 변수 |
설명 |
Azure Location |
리소스를 배포할 Azure 위치입니다. |
Azure Subscription |
리소스를 배포할 Azure 구독입니다. |
원하는 값을 선택하고 Enter 키를 누릅니다. 이 azd up 명령은 템플릿 구성 및 인프라 파일을 사용하여 다음 작업을 처리합니다.
- 다음을 포함하여 필요한 모든 Azure 리소스(
azd provision)를 만들고 구성합니다.
- 사용자의 계정에 대한 액세스 정책 및 역할
- 관리 ID와 서비스 간 통신
- 코드 패키지 및 배포(
azd deploy)
명령이 azd up 성공적으로 완료되면 CLI는 생성된 리소스를 볼 수 있는 두 개의 링크를 표시합니다.
- ToDo API 앱
- ToDo 웹앱 프런트 엔드
참고 항목
애플리케이션에 업데이트를 프로비전하고 배포하는 데 원하는 만큼 여러 번 호출 azd up 할 수 있습니다.
선택한 지역에서 리소스를 배포할 수 없어 배포가 실패할 수 있습니다. 빠른 시작이므로 디렉터리를 삭제 .azure 하고 다시 시도 azd up 해도 안전합니다. 메시지가 표시되면 다른 지역을 선택합니다. 고급 시나리오에서는 디렉터리 내에서 .azure 파일을 선택적으로 편집하여 지역을 변경할 수 있습니다.
Azure Developer CLI는 기능을 azd에서 간소화하기 위한 Visual Studio Code 확장을 제공합니다. 예를 들어 명령을 실행하기 위해 명령 팔레트 인터페이스 azd를 사용할 수 있습니다. 앞으로 단계를 완료하려면 Visual Studio Code용 Azure Developer CLI 확장을 설치해야 합니다.
Azure 개발자 CLI 확장 설치
Visual Studio Code를 엽니다.
보기 메뉴에서 확장을 선택합니다.
검색 필드에 .를 입력합니다 Azure Developer CLI.
설치를 선택하고 설치 프로세스가 완료되기를 기다립니다.
새 앱 초기화
Visual Studio Code에서 빈 디렉터리를 엽니다.
보기 메뉴에서 명령 팔레트를 선택합니다.
Azure Developer CLI (azd): Initialize app (init) 명령을 검색하고 Enter 키를 누릅니다. 이 azd up 명령은 앱 리소스를 azd 프로비전하고 배포하도록 지시합니다.
템플릿 선택 워크플로를 선택합니다.
Azure 템플릿에서 Node.js API 및 MongoDB를 사용하여 React Web App을 검색하고 Enter 키를 눌러 선택합니다.
Visual Studio Code는 azd 템플릿을 복제합니다. 템플릿에는 infra 폴더의 코드 파일로 된 인프라와 src 폴더의 샘플 앱이 포함됩니다. 코드 파일로서의 인프라는 앱이 배포될 때 필요한 Azure에 필요한 리소스를 프로비전합니다.
Azure 템플릿에서 Python API 및 MongoDB를 사용하여 React Web App을 검색하고 Enter 키를 눌러 선택합니다.
Visual Studio Code는 azd 템플릿을 복제합니다. 템플릿에는 infra 폴더의 코드 파일로 된 인프라와 src 폴더의 샘플 앱이 포함됩니다. 코드 파일로서의 인프라는 앱이 배포될 때 필요한 Azure에 필요한 리소스를 프로비전합니다.
Azure 템플릿에서 C# API 및 MongoDB를 사용하여 React Web App을 검색하고 Enter 키를 눌러 선택합니다.
Visual Studio Code는 azd 템플릿을 복제합니다. 템플릿에는 infra 폴더의 코드 파일로 된 인프라와 src 폴더의 샘플 앱이 포함되어 있습니다. 코드 파일로서의 인프라는 앱이 배포될 때 필요한 Azure에 필요한 리소스를 프로비전합니다.
템플릿이 복제되면 Visual Studio Code에서 터미널을 열어 환경 이름을 묻는 메시지를 표시합니다.
azdvscode와 같이 선택한 짧은 이름을 입력하고 Enter 키를 누릅니다.
Enter a new environment name: [? for help] azdvscode
환경 이름은 Azure에서 프로비전된 리소스의 이름에 영향을 줍니다. 템플릿 디렉터리에 특정 환경 설정을 저장할 폴더 .azure 를 만듭니다.
앱 리소스 프로비전 및 배포
명령 팔레트를 열고 Azure Developer CLI (azd): Package, Provision and Deploy(up) 명령을 검색한 다음 Enter 키를 누릅니다. 이 azd up 명령은 앱 리소스를 azd 프로비전하고 배포하도록 지시합니다.
Visual Studio Code는 프로비전 및 배포 프로세스의 진행률을 표시하는 터미널 창을 엽니다.
azd 는 리소스를 배포할 때 프로세스 중에 init 선택한 구독 및 위치 설정을 사용합니다.
참고 항목
프로비전 및 배포 프로세스는 몇 분 정도 걸릴 수 있습니다.
배포 프로세스가 완료되면 제공된 azd 출력 창에서 링크를 선택하여 브라우저에서 사이트를 시작합니다.
Codespaces는 컨테이너화된 클라우드 환경에서 작업하고 로컬로 도구 또는 종속성을 설치하지 않으려는 개발자에게 유용한 옵션입니다.
Codespace 설정
- 파일 목록 위에서 Codespace>.
Codespaces를 사용하면 Visual Studio Code 확장을azd 모든 필수 구성 요소가 설치됩니다.
템플릿 실행
Codespace가 만들어지면 루트 디렉터리에서 azure.yaml을 마우스 오른쪽 단추로 클릭합니다. 옵션 에서 선택(리소스 프로비전 및 Azure에 코드 배포).
명령을 실행 azd up 하면 다음 정보를 제공하고 웹 브라우저 및 인증 코드를 사용하여 로그인하라는 메시지가 표시됩니다.
| 매개 변수 |
설명 |
Environment Name |
모든 Azure 리소스를 보유하기 위해 생성될 리소스 그룹의 접두사입니다. 환경 이름이 azd란? 를 사용하여 항상 새 환경을 azd env new만들 수 있습니다. |
Azure Location |
리소스를 배포할 Azure 위치입니다. |
Azure Subscription |
리소스를 배포할 Azure 구독입니다. |
명령이 다음 작업을 처리하므로 이 프로세스를 완료 azd up 하는 데 다소 시간이 걸릴 수 있습니다.
- 필요한 모든 Azure 리소스(
azd provision)를 만들고 구성합니다.
- 계정에 대한 액세스 정책 및 역할을 구성합니다.
- 관리 ID와 서비스 간 통신을 구현합니다.
- 코드를 패키지하고 배포합니다(
azd deploy).
필요한 매개 변수를 제공하고 명령이 azd up 완료되면 CodeSpaces 터미널에 생성된 리소스를 볼 수 있는 두 개의 Azure Portal 링크가 표시됩니다.
- ToDo API 앱
- ToDo 웹앱 프런트 엔드
무슨 일이 일어났나요?
azd up 명령이 성공적으로 완료되면 다음과 같습니다.
-
템플릿의
README.md 파일에서 참조되는 Azure 리소스는 실행 azd up후 지정한 Azure 구독에 프로비전되었습니다. 이제 Azure Portal을 통해 해당 Azure 리소스를 볼 수 있습니다.
- 앱이 빌드되고 Azure에 배포되었습니다. 명령의 웹앱 URL 출력을
azd up 사용하여 완벽하게 작동하는 앱으로 이동할 수 있습니다.
참고 항목
- 애플리케이션을 프로비전하고 배포하는 데 원하는 횟수만큼 호출
azd up 할 수 있습니다.
- GitHub Codespaces의 알려진 제한 사항으로 인해 웹 브라우저를 시작해야 하는 실행 및 디버그가 현재 지원되지 않습니다. 더 나은 환경을 위해 데스크톱에서 Codespaces를 사용하는 것이 좋습니다.
DevContainer는 로컬 컴퓨터에서 템플릿으로 작업 azd 하는 데 필요한 모든 필수 구성 요소를 포함하는 Docker 이미지입니다. GitHub Codespaces와 같은 클라우드 서비스 대신 로컬 디바이스에서 실행되는 컨테이너화된 환경을 선호하는 개발자에게 적합합니다.
필수 조건
프로젝트 초기화
터미널을 열고, 새 빈 디렉터리를 만들고, 해당 디렉터리로 변경합니다.
다음 명령을 실행하여 프로젝트를 초기화합니다.
azd init --template todo-nodejs-mongo
azd init --template todo-python-mongo
azd init --template todo-csharp-cosmos-sql
azd init --template todo-java-mongo-aca
명령을 실행 azd init 하면 다음 정보를 제공하라는 메시지가 표시됩니다.
| 매개 변수 |
설명 |
Environment Name |
모든 Azure 리소스를 보유하기 위해 생성될 리소스 그룹의 접두사입니다. 환경 이름이 azd란? 를 사용하여 항상 새 환경을 azd env new만들 수 있습니다. |
DevContainer 열기
- VS Code에서 프로젝트를 엽니다.
- F1 키를 누르고 다음을 선택합니다.
Remote-Containers: Rebuild and Reopen in Container
명령 실행 up
다음 명령을 실행합니다.
azd up
명령을 실행 azd up 하면 다음 정보를 제공하라는 메시지가 표시됩니다.
| 매개 변수 |
설명 |
Azure Location |
리소스를 배포할 Azure 위치입니다. |
Azure Subscription |
리소스를 배포할 Azure 구독입니다. |
이 azd up 명령은 다음 단계를 완료할 때 실행하는 데 다소 시간이 걸릴 수 있습니다.
- 다음을 포함하여 필요한 모든 Azure 리소스(
azd provision)를 만들고 구성합니다.
- 사용자의 계정에 대한 액세스 정책 및 역할
- 관리 ID와 서비스 간 통신
- 코드 패키지 및 배포(
azd deploy)
필요한 매개 변수를 제공하고 명령이 azd up 완료되면 CLI는 생성된 리소스를 볼 수 있는 두 개의 Azure Portal 링크를 표시합니다.
- ToDo API 앱
- ToDo 웹앱 프런트 엔드
참고 항목
애플리케이션을 프로비전하고 동일한 지역에 배포하고 첫 번째 실행 azd up 시 제공한 것과 동일한 구성 값을 사용하여 원하는 만큼 실행할 수 있습니다.
리소스 정리
이 문서에서 만든 리소스가 더 이상 필요하지 않은 경우 다음 명령을 실행하여 앱을 전원을 공급합니다.
azd down
다른 지역에 다시 배포하려면 다시 실행 .azure 하기 전에 디렉터리를 삭제 azd up 합니다. 고급 시나리오에서는 디렉터리 내에서 .azure 파일을 선택적으로 편집하여 지역을 변경할 수 있습니다.
도움말 요청
버그를 제출하거나, 도움말을 요청하거나, Azure 개발자 CLI에 대한 새 기능을 제안하는 방법에 대한 자세한 내용은 문제 해결 및 지원 페이지를 참조하세요.
다음 단계