이 빠른 시작에서는 Azure 개발자 CLI(azd) 템플릿 및 몇 가지 azd 명령을 사용하여 Azure 앱 리소스를 프로비전하고 배포하는 방법을 알아봅니다.
azd 템플릿은 애플리케이션 소스 코드뿐만 아니라 Azure 리소스를 프로비전하는 azd 구성 및 인프라 파일을 포함하는 표준 코드 리포지토리입니다.
azd 템플릿 및 Azure 프로비저닝 및 배포 프로세스를 가속화하는 방법에 대한 자세한 내용은 Azure 개발자 CLI 템플릿이란 무엇입니까?를 참조하세요.
템플릿 선택 및 배포
다음 단계를 수행하려면 다음 템플릿을 사용하여 Azure 앱을 프로비전하고 배포합니다.
Azure에서 C# API 및 MongoDB와 함께 React 웹 애플리케이션
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
메시지가 표시되면 azdquickstart 같은 환경 이름을 입력합니다. 이 경우 Azure 리소스를 포함하도록 만들 리소스 그룹에 대한 명명 접두사를 설정합니다.
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 개발자 CLI는 azd 기능으로 작업을 간소화하는 Visual Studio Code 확장을 제공합니다. 예를 들어 명령을 실행하기 위해 명령 팔레트 인터페이스 azd를 사용할 수 있습니다. Visual Studio Code Azure 개발자 CLI 확장을 설치하여 단계를 완료해야 합니다.
Azure 개발자 CLI 확장 설치
Visual Studio Code 엽니다.
보기 메뉴에서 확장을 선택합니다.
검색 필드에 Azure Developer CLI 입력합니다.
설치를 선택하고 설치 프로세스가 완료되기를 기다립니다.
새 앱 초기화
Visual Studio Code 빈 디렉터리를 엽니다.
보기 메뉴에서 명령 팔레트를 선택합니다.
Azure Developer CLI (azd): Initialize app (init) 명령을 검색하고 Enter 키를 누릅니다. 이 azd up 명령은 앱 리소스를 azd 프로비전하고 배포하도록 지시합니다.
템플릿 선택 워크플로를 선택합니다.
Azure에서 React 웹 앱 템플릿(Node.js API 및 MongoDB 사용)을 검색하고 Enter 키를 눌러 선택합니다.
비주얼 스튜디오 코드가 azd 템플릿을 클론하여 로컬에 복사합니다. 템플릿에는 infra 폴더의 코드 파일로 된 인프라와 src 폴더의 샘플 앱이 포함됩니다. 코드 파일로서의 인프라는 앱이 배포될 때 필요한 Azure 필요한 리소스를 프로비전합니다.
Azure 템플릿에서 React 웹앱과 Python API 및 MongoDB를 검색하고 Enter 키를 눌러 선택합니다.
Visual Studio Code가 azd 템플릿을 다운로드하여 복제합니다. 템플릿에는 infra 폴더의 코드 파일로 된 인프라와 src 폴더의 샘플 앱이 포함됩니다. 코드 파일로서의 인프라는 앱이 배포될 때 필요한 Azure 필요한 리소스를 프로비전합니다.
Azure에서 C# API 및 MongoDB와 함께 사용하는 React 웹 앱 템플릿을 검색하고 Enter 키를 눌러 선택합니다.
Visual Studio Code가 azd 템플릿을 클론하여 다운로드합니다. 템플릿에는 infra 폴더의 코드 파일로 된 인프라와 src 폴더의 샘플 앱이 포함됩니다. 코드 파일로서의 인프라는 앱이 배포될 때 필요한 Azure 필요한 리소스를 프로비전합니다.
Azure 템플릿에서 Java API 및 MongoDB를 사용하여 Containerized React Web App을 검색하고 enter 키를 눌러 it.awesome-azd를 선택합니다.
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 설정
- 브라우저에서 Azure의 React 웹앱(Node.js API 및 MongoDB 사용) 템플릿으로 이동하거나 Awesome AZD 중에서 하나를 선택합니다.
- 브라우저에서 Azure 템플릿에서 Java API 및 MongoDB를 사용하여 Containerized React Web App으로 이동하거나 Awesome AZD 중 하나를 선택합니다.
- 파일 목록 위에서 이 템플릿 사용을 클릭한 후 >Codespace에서 열기를 선택하세요.
Codespaces를 사용하면 azd Visual Studio Code 확장 등 모든 필수 구성 요소가 설치됩니다.
템플릿 실행
Codespace가 만들어지면 루트 디렉터리에서 azure.yaml을 마우스 오른쪽 단추로 클릭합니다. 옵션에서 up(리소스 프로비전 및 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 포털 링크가 표시됩니다.
- ToDo API 앱
- ToDo 웹 애플리케이션 프론트엔드
무슨 일이 일어났나요?
azd up 명령이 성공적으로 완료되면 다음과 같습니다.
- 템플릿의
README.md 파일에서 참조된 Azure 리소스는 azd up를 실행한 후에 지정하신 Azure 구독에 프로비전되었습니다. 이제 Azure 포털 통해 이러한 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 포털 링크를 표시합니다.
- ToDo API 앱
- ToDo 웹 애플리케이션 프론트엔드
참고
애플리케이션을 프로비전하고 동일한 지역에 배포하고 첫 번째 실행 azd up 시 제공한 것과 동일한 구성 값을 사용하여 원하는 만큼 실행할 수 있습니다.
리소스 정리
이 문서에서 만든 리소스가 더 이상 필요하지 않은 경우, 다음 명령을 실행하여 앱의 전원을 끕니다.
azd down
다른 지역에 다시 배포하려면 다시 실행 .azure 하기 전에 디렉터리를 삭제 azd up 합니다. 고급 시나리오에서는 디렉터리 내에서 .azure 파일을 선택적으로 편집하여 지역을 변경할 수 있습니다.
도움말 요청
버그를 제출하거나, 도움말을 요청하거나, Azure 개발자 CLI에 대한 새 기능을 제안하는 방법에 대한 자세한 내용은 troubleshooting and support 페이지를 방문하세요.
다음 단계