새 Azure 개발자 CLI(azd) 템플릿으로 시작

다른 작성 방법을 사용하여 새 Azure 개발자 CLI(azd) 템플릿에서 표준 파일을 빌드할 수 있습니다.

  • azd init에서 GitHub Copilot 통합을 사용하세요. 기본 제공 워크플로는 기존 프로젝트 파일을 분석하거나 새 프로젝트를 계획하고 템플릿 자산을 만들고 배포 전 유효성 검사를 실행하는 데 도움이 됩니다.
  • 다른 AI 코딩 도우미를 사용합니다. 어시스턴트에게 azure.yaml와 직접 통합하지 않고 동일한 azd init, 인프라 코드, 애플리케이션 및 지원 파일을 만들도록 요청합니다.
  • 파일을 직접 작성합니다. 완전한 제어를 원하거나 AI 코딩 도우미를 사용하지 않으려면 템플릿 자산을 직접 만들고 편집합니다.

이 문서에서는 기본적으로 기본 제공 GitHub Copilot 워크플로에 중점을 둡니다. 이 워크플로는 통합된 azd가이드 환경을 제공하기 때문입니다. 제작 방법에 관계없이 배포하기 전에 모든 파일을 검토하고 유효성을 검사합니다.

Important

azd init의 GitHub Copilot 통합은 미리 보기 상태입니다. 미리 보기 기능은 일반 공급 전에 변경됩니다. 자세한 내용은 기능 버전 관리 및 릴리스 전략을 참조azd하세요.

생성된 자산은 편집 가능한 azd 표준 템플릿 파일입니다. 초기화 후 직접 또는 AI 코딩 도우미를 사용하여 업데이트할 수 있습니다.

GitHub Copilot 위한 필수 구성 요소

기본 제공 Copilot 워크플로를 사용하려면 다음이 필요합니다.

  • Azure Developer CLI 1.23.11 이상.
  • 활성 GitHub Copilot 구독입니다.
  • Git- azd init 파일을 수정하기 전에 작업 트리를 검사하는 데 사용합니다.
  • 대화형 터미널 세션입니다.

아직 GitHub Copilot azd 인증되지 않은 경우 로그인하라는 메시지가 표시됩니다.

실행 azd version 하여 설치된 Azure Developer CLI 버전을 확인합니다.

메모

워크플로는 azd init 터미널에서 전용 GitHub Copilot 에이전트 세션을 시작합니다. Visual Studio Code에서 활성 GitHub Copilot Chat 세션을 사용하거나 이어가지 않습니다.

GitHub Copilot 사용하여 빌드

  1. 템플릿을 빌드하려는 디렉터리에서 터미널을 엽니다.

    메모

    디렉터리에는 기존 애플리케이션, 인프라 프로젝트 또는 새 솔루션에 대한 초기 파일이 포함될 수 있습니다. 디렉터리에 커밋되지 않은 변경 내용 azd 이 포함된 경우 계속하기 전에 확인하도록 요청합니다. 중요한 변경 내용을 먼저 커밋하거나 숨깁니다.

  2. azd init를 실행합니다.

    azd init

  3. GitHub Copilot(미리 보기) 사용하여 설정을 선택합니다.

    초기화 프롬프트는 다음 예제와 유사합니다.

    ? How do you want to initialize your app?
   Scan current directory
   Select a template
> Set up with GitHub Copilot (Preview)

  4. 요청된 도구 액세스를 검토하고 워크플로에 필요한 도구에 대한 액세스 권한을 부여합니다. Copilot은 azd와 Azure 개발 기능을 사용하여 프로젝트를 검사하고, 파일을 만들고, 결과를 검증합니다.

  5. 구성하라는 메시지가 표시되면 azd 모델 및 추론 수준을 선택합니다.

    첫 번째 실행에서 프롬프트는 다음 레이블을 사용합니다. 사용 가능한 모델 및 추론 선택은 GitHub Copilot 계정 및 선택한 모델에 따라 달라집니다.

    ? Select AI model
? Select reasoning effort level

  6. 빌드하려는 항목을 설명합니다. 다음과 같은 관련 요구 사항을 포함합니다.

    • 템플릿에 애플리케이션 코드, 인프라만 포함되는지 또는 둘 다 포함되는지 여부입니다.
    • 애플리케이션 언어 및 프레임워크(알려진 경우)입니다.
    • 사용할 Azure 서비스 및 호스팅 플랫폼입니다.
    • Bicep 또는 Terraform을 사용할지 여부입니다.
    • 보안, 네트워킹, 크기 조정 및 지역 요구 사항

    다음은 그 예입니다.

    Build an infrastructure-only azd template that provisions an Azure Container Apps
environment, Azure Container Registry, and Log Analytics workspace with Bicep.
Use managed identity and least-privilege role assignments. Parameterize the location
and environment name so the template can be reused.

  7. Copilot의 아키텍처 또는 구성 관련 질문에 답변하세요. 에이전트는 Azure 위해 프로젝트를 준비하고 템플릿 자산을 생성하며 배포 전 유효성 검사를 실행합니다.

  8. Copilot이 만들거나 변경한 파일의 전체 구조를 검토하세요. 템플릿에 솔루션에 대한 예상 프로젝트 구성, 인프라 디렉터리, 애플리케이션 원본 및 지원 자산이 포함되어 있음을 확인합니다.

    예를 들어 생성된 인프라 전용 템플릿에는 다음 키 파일이 포함될 수 있습니다.

    azure.yaml
infra/
├── main.bicep
├── main.parameters.json
└── modules/
   ├── container-apps-environment.bicep
   └── container-registry.bicep

    구성 및 인프라 콘텐츠를 검토하는 방법에 대한 자세한 지침은 템플릿 파일 탐색 및 편집을 참조하세요.

템플릿 프로비전 및 배포

생성된 파일을 승인한 후 다음 명령을 실행합니다.

azd up

이 명령은 환경을 만들거나 선택하고azd, Azure 리소스를 프로비전하고, 모든 애플리케이션 서비스를 패키지하고, 배포합니다. 자세한 명령 분석은 워크플로 탐색을 azd up참조하세요.

다른 제작 방법 사용

다른 AI 코딩 도우미는 워크플로에 azd init 직접 연결되지 않지만 동일한 표준 템플릿 자산을 만들 수 있습니다. 모든 자산을 직접 작성할 수도 있습니다.

이러한 자산을 직접 만들거나 다른 코딩 도우미에게 요구 사항을 분석하고 만들도록 요청합니다.

  • azure.yaml 프로젝트 및 배포 가능한 서비스를 정의하는 파일입니다.
  • 필요한 Azure 리소스를 프로비전하는 Bicep 또는 Terraform 파일입니다.
  • 리소스 출력 및 애플리케이션 환경 변수입니다.
  • 필요한 경우 Dockerfiles, 배포 구성 및 지원 스크립트.

다른 에이전트를 사용하기 전에 최소 시작점을 제공하려면 다음을 실행합니다.

azd init --minimal

다른 코딩 도우미를 사용하는 경우 스키마, Azure 인프라 보안 사례 및 Azure 개발자 CLI 템플릿에 설명된 템플릿 규칙을 따르azure.yaml도록 지시합니다. 파일을 직접 작성하는 경우 구현 가이드와 동일한 참조를 사용합니다. 실행 azd up하기 전에 모든 파일을 검토하고 유효성을 검사합니다.

관련 콘텐츠

도움말 요청

버그를 제출하거나, 도움말을 요청하거나, Azure 개발자 CLI에 대한 새 기능을 제안하는 방법에 대한 자세한 내용은 troubleshooting and support 페이지를 방문하세요.

  • Last updated on