앱 디렉터리의 코드를 사용하여 앱에 Azure 개발자 CLI 지원 추가

Azure 개발자 CLI(azd)는 앱에 사용할 템플릿을 초기화하는 두 가지 워크플로를 제공합니다. 여기에는 다음이 포함됩니다.

  • 현재 디렉터리의 코드 사용: 이 방법은 앱을 분석하고 지원되는 인프라 및 구성 리소스를 자동으로 생성합니다.
  • 템플릿 선택: 이 방법을 사용하면 기존 템플릿을 앱과 통합하거나 기존 템플릿을 새 앱의 시작점으로 사용할 수 있습니다.

이러한 두 가지 방법은 Azure 개발자 CLI 만들기 템플릿 개요 문서에서 설명합니다.

이 문서에서는 azd 접근 방식의 코드 사용을 통해 앱에 Azure 개발자 CLI()에 대한 지원을 추가하는 방법을 알아봅니다. 대체 방법에 대한 자세한 내용은 기존 템플릿 문서를 사용하여 앱에 추가 azd 지원을 방문하세요 . 템플릿 빌드에 대한 자세한 내용은 학습 - 템플릿 빌드 및 배포 azd 를 azd 참조할 수도 있습니다.

현재 디렉터리에서 코드 사용

  1. 사용자 고유의 프로젝트를 사용하여 앞으로의 단계를 수행할 수 있습니다. 그러나 샘플 애플리케이션을 사용하여 수행하려는 경우 다음 시작 리포지토리를 컴퓨터의 빈 디렉터리에 복제합니다.

    git clone https://github.com/Azure-Samples/msdocs-python-flask-webapp-quickstart

  2. 프로젝트의 루트 디렉터리에 터미널을 엽니다.

  3. azd init 명령을 실행하여 템플릿을 초기화합니다.

    azd init

  4. 메시지가 표시되면 현재 디렉터리에서 코드를 사용하는 옵션을 선택합니다. azd는 프로젝트를 분석하고 검색된 서비스 및 권장 Azure 호스팅 리소스에 대한 요약을 제공합니다.

  5. 확인을 선택하고 내 앱을 계속 초기화합니다. azd 는 프로젝트 루트 디렉터리에 다음 자산을 생성합니다.

    • azure.yaml 적절한 서비스 정의가 있는 파일입니다.
    • infra 프로젝트를 프로비전하고 Azure 배포할 코드로서의 인프라 파일이 있는 폴더입니다.
    • .azure 파일에 환경 변수가 설정된 폴더입니다.env.

    이 검색 및 생성 프로세스에 대한 자세한 내용은 이 문서의 뒷부분에서 제공합니다.

  6. 생성된 파일은 제공된 샘플 앱에 대해 as-is 작동하며 사용자 고유의 앱에도 사용할 수 있습니다. 필요한 경우 생성된 파일을 필요에 맞게 수정할 수 있습니다. 예를 들어 앱이 식별infra된 리소스 외에 Azure 리소스를 사용하는 경우 폴더에서 azd 코드로서의 인프라 파일을 추가로 수정해야 할 수 있습니다.

  7. azd up 명령을 실행하여 앱을 Azure에 프로비저닝하고 배포합니다.

    azd up

  8. 메시지가 표시되면 원하는 구독 및 위치를 선택하여 프로비전 및 배포 프로세스를 시작합니다.

  9. 프로세스가 완료되면 출력의 링크를 azd 클릭하여 브라우저에서 앱을 엽니다.

초기화 단계 살펴보기

현재 디렉터리 워크플로 azd init 에서 코드 사용을 선택하면 이 명령은 프로젝트를 분석하고 검색된 내용에 따라 코드를 자동으로 생성합니다. 아래 섹션에서는 이 프로세스의 작동 방식과 현재 지원되는 기술에 대한 세부 정보를 설명합니다.

탐지

이 azd init 명령은 프로젝트 디렉터리 및 하위 디렉터리에 있는 지원되는 언어에 대한 프로젝트 파일을 검색합니다. azd 또한 패키지 종속성을 검사하여 앱에서 사용하는 웹 프레임워크 또는 데이터베이스에 대한 정보를 수집합니다. 필요한 경우 확인 요약 프롬프트에 표시된 대로 검색된 구성 요소를 수동으로 추가하거나 편집할 수 있습니다.

현재 감지 로직은 다음과 같습니다.

  • 지원되는 언어:
    • 파이썬
    • 자바스크립트/타입스크립트
    • .NET
    • Java
  • 지원되는 데이터베이스:
    • MongoDB
    • PostgreSQL
  • Python 및 JavaScript/TypeScript의 경우 웹 프레임워크 및 데이터베이스가 자동으로 검색됩니다.
  • JavaScript/TypeScript 프로젝트에서 프런트 엔드(또는 클라이언트 쪽) 웹 프레임워크를 사용하는 경우 프런트 엔드 서비스로 분류됩니다. 서비스에서 현재 검색되지 않은 프런트 엔드 웹 프레임워크를 사용하는 경우 JQuery를 선택하여 동등한 프런트 엔드 서비스 분류 및 동작을 제공할 수 있습니다.

Generation

검색된 구성 요소를 azd init 확인한 후 애플리케이션을 Azure 배포하는 데 필요한 코드로서의 인프라 파일을 생성합니다.

생성 논리는 다음과 같습니다.

  • 지원되는 호스트:
    • Azure Container Apps.
  • 데이터베이스의 경우 데이터베이스 기술과 서비스 간에 지원되는 매핑이 사용됩니다.
    • MongoDB: Azure CosmosDB API for MongoDB
    • PostgreSQL: Azure Database for PostgreSQL 유연한 서버
    • Redis: Azure Container Apps Redis 추가 기능
  • 데이터베이스를 사용하는 서비스에는 기본적으로 미리 구성된 데이터베이스에 대한 연결을 제공하는 환경 변수가 있습니다.
  • 프런트 엔드 및 백 엔드 서비스가 모두 검색되면 백 엔드 서비스에 대한 Azure 호스트의 CORS 구성이 프런트 엔드 서비스의 기본 호스팅 도메인을 허용하도록 업데이트됩니다. 코드 구성 파일로 인프라에서 필요에 따라 수정하거나 제거할 수 있습니다.

개발 컨테이너에 대한 지원 추가

템플릿을 개발 컨테이너 및 Codespaces와 호환되도록 만들 수도 있습니다. 개발 컨테이너를 사용하면 컨테이너를 완전한 기능을 갖춘 개발 환경으로 사용할 수 있습니다. 애플리케이션을 실행하고, 코드베이스 작업에 필요한 도구, 라이브러리 또는 런타임을 분리하고, 지속적인 통합 및 테스트를 지원하는 데 사용할 수 있습니다. 개발 컨테이너는 프라이빗 또는 퍼블릭 클라우드에서 로컬 또는 원격으로 실행할 수 있습니다. (원본: https://containers.dev/)

개발 컨테이너에 대한 지원을 추가하려면 다음을 수행합니다.

  1. 프로젝트의 루트에 .devcontainer 폴더를 만듭니다.

  2. 원하는 구성을 devcontainer.json 사용하여 .devcontainer 폴더 내부에 파일을 만듭니다. 시작 템플릿은 azd 프로젝트에 복사하고 필요에 따라 수정할 수 있는 샘플 devcontainer.json 파일을 제공합니다.

Visual Studio Code 설명서에서 개발 컨테이너 작업에 대해 자세히 알아보세요.

CI/CD 파이프라인에 대한 지원 추가

GitHub 작업을 사용하거나 다음 단계를 사용하여 Azure DevOps 사용하여 템플릿에서 CI/CD에 대한 지원을 추가할 수도 있습니다.

  1. .github GitHub 작업에 대한 폴더 또는 .ado 프로젝트의 루트에 Azure DevOps 폴더를 추가합니다.

  2. 새 폴더에 워크플로 파일을 추가합니다. 시작 템플릿은 azd 각 플랫폼에 대한 샘플 GitHub Actions 워크플로 파일 및 샘플 Azure DevOps Pipelines 파일을 제공합니다. 이러한 파일을 프로젝트에 복사하고 필요에 따라 수정할 수 있습니다.

  3. 워크플로가 실행되려면 필요한 환경 변수로 infra 폴더의 main.parameters.json 파일을 업데이트해야 할 수도 있습니다.

  • Last updated on