템플릿 구조체 만들기

완료됨

Azure Developer CLI(azd)는 azd init 명령 및 시작 템플릿을 사용하여 앱의 새 템플릿을 빌드하는 데 도움이 됩니다. 이 단원에서는 모듈의 나머지 부분에 대해 빌드할 새 템플릿의 기본 스캐폴딩 또는 구조체를 만듭니다.

  1. 로컬 머신의 빈 디렉터리에서 azd init 명령을 실행합니다.

    azd init
    
  2. 명령 출력에는 시작 템플릿의 목록과 전체 샘플 앱 옵션이 표시됩니다. 시작 템플릿에는 필수 폴더 구조, 시작 IaC(Infrastructure as code) 파일, 템플릿 빌드를 시작하기 위한 기타 상용구 구성 파일이 포함됩니다. 전체 샘플 템플릿에는 자리 표시자 애플리케이션 코드와 이를 배포하는 데 필요한 파일도 포함되어 있습니다. 이 모듈에서는 기존 앱 코드를 수정하는 대신 고유한 템플릿을 빌드하는 방법을 알아보므로 목록에서 Starter - Bicep 옵션을 선택합니다. Azure Developer CLI는 해당 옵션을 원하는 경우 Terraform 사용도 지원합니다. Terraform 지원은 현재 알파 버전이며 수동으로 사용하도록 설정해야 합니다.

  3. 환경 이름을 묻는 메시지가 표시되면 azdlearn 또는 선택한 이름을 입력합니다. 환경 이름은 Azure에서의 프로비전한 리소스 이름 지정에 영향을 줍니다.

  4. 폴더 집합은 현재 디렉터리 내에 만들어집니다.

    The starter template structure.

참고 항목

azd init 명령은 가능한 가장 간단한 템플릿 구조를 포함하는 Minimal이라는 프로젝트 템플릿도 제공하는 것을 확인할 수 있습니다. 그러나 선택한 Starter - Bicep 템플릿에는 매우 유용하지만 여전히 기술에 구애받지 않는 추가 스캐폴딩 코드가 포함되어 있으므로 시작하기에 좋은 선택인 경우가 많습니다.

생성된 폴더는 azd 템플릿의 모든 필수 구성 요소를 제공합니다.

  • .azdo - Azure Pipelines를 사용하는 CI/CD의 시작 .yml 구성 파일을 포함하는 폴더입니다.
  • .azure - 환경 이름과 같이 템플릿의 Azure 환경에 대한 필수 설정을 포함하는 폴더입니다.
  • .devcontainer - 개발 컨테이너 환경에서 템플릿을 실행하는 데 사용되는 구성 파일이 포함된 폴더입니다.
  • .github - GitHub 작업을 통해 CI/CD 파이프라인을 설정하는 시작 .yml 구성 템플릿이 포함된 폴더입니다.
  • infra - 템플릿의 IaC(Infrastructure as code)에 대한 시작 Bicep 파일을 포함하는 폴더입니다. Terraform 시작 템플릿을 선택한 경우 이 폴더에는 Terraform 파일이 대신 포함됩니다.
  • azure.yaml - 애플리케이션의 일부가 Azure의 서비스에 매핑되는 방식을 설명하는 파일입니다.

이 시작 템플릿에는 사용자 고유의 azd 템플릿을 만드는 데 필요한 대부분의 항목이 포함되어 있습니다. 다음 몇 단원에서는 이러한 기존 파일을 업데이트하고 새 자산을 추가하여 전체 템플릿을 빌드하는 방법을 알아봅니다.