다음을 통해 공유

APM 통합 및 CA 인증서를 구성하는 방법

  • 아티클

참고 항목

기본, 표준 및 엔터프라이즈 계획은 2025년 3월 중순부터 사용되지 않으며 3년의 은퇴 기간이 있습니다. Azure Container Apps로 전환하는 것이 좋습니다. 자세한 내용은 Azure Spring Apps 사용 중지 공지 사항을 참조하세요.

표준 소비 및 전용 계획은 2024년 9월 30일부터 사용되지 않으며 6개월 후에 완전히 종료됩니다. Azure Container Apps로 전환하는 것이 좋습니다. 자세한 내용은 Azure Spring Apps 표준 사용량 및 전용 계획을 Azure Container Apps로 마이그레이션을 참조 하세요.

이 문서는 기본/표준 ✅ 엔터프라이즈에 ❎ 적용됩니다.

이 문서에서는 Azure Spring Apps 엔터프라이즈 플랜에서 APM(애플리케이션 성능 모니터) 통합 및 CA(인증 기관) 인증서를 구성하는 방법을 보여줍니다.

Azure Springs Apps 엔터프라이즈 플랜 인스턴스에서 Tanzu Build Service를 사용하거나 사용하지 않도록 설정할 수 있습니다. 자세한 내용은 Tanzu Build Service 사용의 주문형 빌드 서비스 섹션을 참조하세요.

필수 조건

지원되는 시나리오 - APM 및 CA 인증서 통합

Tanzu Build Service는 빌드팩 바인딩을 사용하여 Tanzu 파트너 빌드팩 및 기타 클라우드 네이티브 빌드팩(예: GitHub의 ca-certificates 빌드팩)과 통합합니다.

현재 Azure Spring Apps에서 지원하는 APM 형식은 다음과 같습니다.

  • ApplicationInsights
  • Dynatrace
  • AppDynamics
  • New Relic
  • ElasticAPM

Azure Spring Apps는 모든 언어 패밀리 빌드팩에 대해 CA 인증서를 지원하지만, 지원되는 APM을 모두 지원하지는 않습니다. 다음 표에서는 Tanzu 언어 패밀리 빌드팩에서 지원하는 바인딩 형식을 보여 줍니다.

빌드팩 ApplicationInsights New Relic AppDynamics Dynatrace ElasticAPM
Java ✔ ✔ ✔ ✔ ✔
.NET ✔ ✔
Go ✔
Python
NodeJS ✔ ✔ ✔ ✔
웹 서버 ✔
Java 네이티브 이미지
PHP ✔ ✔ ✔

웹 서버를 사용하는 방법에 대한 자세한 내용은 웹 정적 파일 배포를 참조하세요.

Tanzu Build Service는 Azure Spring Apps 엔터프라이즈에서 기본적으로 사용하도록 설정됩니다. 빌드 서비스를 사용하지 않도록 선택하는 경우 애플리케이션을 배포할 수 있지만 사용자 지정 컨테이너 이미지를 사용해야 합니다. 이 섹션에서는 빌드 서비스 사용 및 사용 안 함 시나리오 모두에 대한 지침을 제공합니다.

지원되는 APM 형식

이 섹션에는 통합에 사용할 수 있는 APM에 지원되는 언어와 필요한 환경 변수가 나와 있습니다.

  • Application Insights

    지원되는 언어:

    • Java

    빌드팩 바인딩에 필요한 환경 변수:

    • connection-string

    지원되는 다른 환경 변수에 대해서는 Application Insights 개요를 참조하세요.

  • DynaTrace

    지원되는 언어:

    • Java
    • .NET
    • Go
    • Node.js
    • WebServers
    • PHP

    빌드팩 바인딩에 필요한 환경 변수:

    • api-url 또는 environment-id(빌드 단계에서 사용)
    • api-token(빌드 단계에서 사용)
    • TENANT
    • TENANTTOKEN
    • CONNECTION_POINT

    기타 지원되는 환경 변수는 Dynatrace를 참조하세요.

  • New Relic

    지원되는 언어:

    • Java
    • .NET
    • Node.js
    • PHP

    빌드팩 바인딩에 필요한 환경 변수:

    • license_key
    • app_name

    기타 지원되는 환경 변수는 New Relic을 참조하세요.

  • Elastic

    지원되는 언어:

    • Java
    • Node.js
    • PHP

    빌드팩 바인딩에 필요한 환경 변수:

    • service_name
    • application_packages
    • server_url

    기타 지원되는 환경 변수는 Elastic을 참조하세요.

  • AppDynamics

    지원되는 언어:

    • Java
    • Node.JS

    빌드팩 바인딩에 필요한 환경 변수:

    • agent_application_name
    • agent_tier_name
    • agent_node_name
    • agent_account_name
    • agent_account_access_key
    • controller_host_name
    • controller_ssl_enabled
    • controller_port

    기타 지원되는 환경 변수는 AppDynamics를 참조하세요.

작성기의 바인딩은 더 이상 사용되지 않음

참고 항목

이전에는 작성기의 바인딩을 통해 APM 통합 및 CA 인증서를 관리했습니다. 작성기의 바인딩 기능은 더 이상 사용되지 않으며 나중에 제거될 예정입니다. 바인딩에 구성된 APM을 마이그레이션하는 것이 좋습니다. 자세한 내용은 바인딩에 구성된 APM 마이그레이션 섹션을 참조하세요.

사용자 고유의 컨테이너 레지스트리를 빌드 서비스에 사용하거나 빌드 서비스를 사용하지 않도록 설정하면 작성기의 바인딩 기능을 사용할 수 없습니다.

관리형 Azure Container Registry를 빌드 서비스에 사용하는 경우 이전 버전과의 호환성을 위해 레지스트리를 계속 사용할 수 있지만 나중에 제거될 예정입니다.

Azure CLI를 사용하여 서비스 인스턴스를 만들면 다음 오류 메시지가 표시될 수 있습니다. Buildpack bindings feature is deprecated, it's not available when your own container registry is used for build service or build service is disabled 이 메시지는 이전 버전의 Azure CLI를 사용하고 있음을 나타냅니다. 이 문제를 해결하려면 Azure CLI를 업그레이드합니다. 자세한 내용은 Azure CLI를 업데이트하는 방법을 참조하세요.

앱 빌드 및 배포에 대한 APM 통합 구성

APM은 Azure Spring Apps에서 다음 두 가지 방법으로 구성할 수 있습니다.

  • 서비스 인스턴스 수준에서 APM 구성을 관리하고 이러한 구성을 참조하여 앱 빌드 및 배포에 바인딩합니다. 이 방법은 APM을 구성하는 데 권장되는 방법입니다.

  • 작성기의 바인딩을 통해 APM 구성을 관리하고 작성기를 참조하여 앱 빌드 및 배포에 바인딩합니다.

참고 항목

이 방법은 APM을 구성하는 이전 방법이며 이제는 더 이상 사용되지 않습니다. 바인딩에 구성된 APM을 마이그레이션하는 것이 좋습니다. 자세한 내용은 바인딩에 구성된 APM 마이그레이션 섹션을 참조하세요.

이제 서비스 인스턴스 수준에서 APM 구성을 관리하여 Azure Spring Apps에서 APM을 구성하고 이러한 구성을 참조하여 앱 빌드 및 배포에 바인딩할 수 있습니다. 이 방법은 APM을 구성하는 데 권장되는 방법입니다.

다음 섹션에서는 이러한 두 가지 방법 모두에 대한 지침을 제공합니다.

다음 섹션에서 설명하는 대로 APM 구성을 만들고 앱 빌드 및 배포에 바인딩할 수 있습니다.

Azure Spring Apps에서 APM 구성 관리

Azure Portal 또는 Azure CLI를 사용하여 APM 구성에서 속성 또는 비밀을 구성하여 APM 통합을 관리할 수 있습니다.

참고 항목

APM 구성을 통해 속성 또는 비밀을 구성하는 경우 APM 이름이 없는 키 이름을 접두사로 사용합니다. 예를 들어 Dynatrace의 경우 DT_ 접두사를 사용하지 않고 Application Insights의 경우 APPLICATIONINSIGHTS_를 사용하지 않습니다. Tanzu APM 빌드팩은 키 이름을 접두사가 포함된 원래 환경 변수 이름으로 변환합니다.

앱 이름이나 앱 수준과 같은 일부 속성 또는 비밀을 재정의하거나 구성하려면 APM 이름이 있는 원래 환경 변수를 접두사로 사용하여 앱을 배포할 때 환경 변수를 설정해야 합니다.

다음 단계를 사용하여 APM 구성을 표시, 추가, 편집 또는 삭제합니다.

  1. Azure Portal을 엽니다.

  2. 탐색 창에서 APM을 선택합니다.

  3. APM 구성을 만들려면 추가를 선택합니다. APM 구성을 전역적으로 사용하도록 설정하려면 전역적으로 사용을 선택합니다. 모든 후속 빌드 및 배포에서 APM 구성을 자동으로 사용합니다.

    추가 단추가 강조 표시된 APM 구성 페이지를 보여 주는 Azure Portal의 스크린샷.

  4. APM 구성을 보거나 편집하려면 구성에 대한 줄임표(...) 단추를 선택한 다음, APM 편집을 선택합니다.

    APM 편집 옵션이 선택된 APM 구성 페이지를 보여 주는 Azure Portal의 스크린샷.

  5. APM 구성을 삭제하려면 구성에 대한 줄임표(...) 단추를 선택한 다음, 삭제를 선택합니다. APM 구성이 빌드 또는 배포에서 사용되는 경우 삭제할 수 없습니다.

    삭제 단추가 강조 표시된 APM 구성 페이지를 보여 주는 Azure Portal의 스크린샷.

다음 단계를 사용하여 빌드에 바인딩된 APM 구성을 확인합니다.

  1. Azure Spring Apps 인스턴스에 대한 빌드 서비스 페이지로 이동합니다.

    현재 빌드가 목록에 있는 빌드 서비스 페이지를 보여 주는 Azure Portal의 스크린샷.

  2. 탐색 창의 설정 섹션에서 APM 바인딩을 선택합니다.

  3. APM 바인딩 페이지에서 빌드에 바인딩된 APM 구성을 확인합니다.

    빌드에 바인딩된 APM 구성을 보여 주는 APM 바인딩 페이지의 스크린샷.

다음 단계를 사용하여 배포에 바인딩된 APM 구성을 확인합니다.

  1. 애플리케이션 페이지로 이동합니다.

  2. 탐색 창의 설정 섹션에서 APM 바인딩을 선택합니다.

  3. APM 바인딩 페이지에서 배포에 바인딩된 APM 구성을 확인합니다.

    배포에 바인딩된 APM 구성을 보여 주는 APM 바인딩 페이지의 스크린샷.

빌드팩에 대한 properties 및 secrets 매개 변수와 관련된 자세한 내용은 지원되는 시나리오 - APM 및 CA 인증서 통합 섹션을 참조하세요.

앱 빌드 및 배포에 바인딩

관리형 Azure Container Registry를 사용하는 빌드 서비스의 경우 다음 명령을 사용하여 APM을 배포에 통합합니다.

az spring app deploy \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <app-name> \
    --builder <builder-name> \
    --apms <APM-name> \
    --artifact-path <path-to-your-JAR-file>

APM 구성을 전역적으로 사용하도록 설정하면 모든 후속 빌드 및 배포에서 이 구성을 자동으로 사용하므로 --apms 매개 변수를 지정할 필요가 없습니다. 전역적으로 배포에 사용하도록 설정된 APM 구성을 재정의하려면 --apms 매개 변수를 통해 APM 구성을 지정합니다.

사용자 고유의 컨테이너 레지스트리를 사용하는 빌드 서비스의 경우 애플리케이션을 컨테이너 이미지에 빌드하고, 해당 이미지를 현재 또는 다른 Azure Spring Apps 엔터프라이즈 서비스 인스턴스에 배포할 수 있습니다.

사용자 고유의 컨테이너 레지스트리를 제공하면 빌드와 배포가 분리됩니다. 빌드 명령을 사용하여 작성기에서 빌드를 만들거나 업데이트한 다음, 배포 명령을 사용하여 컨테이너 이미지를 서비스에 배포할 수 있습니다.

다음 명령을 사용하여 이미지를 빌드하고 APM을 구성합니다.

az spring build-service build <create|update> \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <app-name> \
    --builder <builder-name> \
    --apms <APM-name> \
    --artifact-path <path-to-your-JAR-file>

APM 구성을 전역적으로 사용하도록 설정하면 모든 후속 빌드 및 배포에서 이 구성을 자동으로 사용하므로 --apms 매개 변수를 지정할 필요가 없습니다. 전역적으로 빌드에 사용하도록 설정된 APM 구성을 재정의하려면 --apms 매개 변수를 통해 APM 구성을 지정합니다.

다음 명령을 사용하여 이전에 빌드된 컨테이너 이미지를 통해 애플리케이션을 배포하고 APM을 구성합니다. 전역적으로 사용하도록 설정된 APM 구성을 사용하거나 --apms 매개 변수를 사용하여 APM 구성을 지정할 수 있습니다.

az spring app deploy \
   --resource-group <resource-group-name> \
   --service <Azure-Spring-Apps-instance-name> \
   --name <app-name> \
   --container-image <your-container-image> \
   --container-registry <your-container-registry> \
   --registry-password <your-password> \
   --registry-username <your-username> \
   --apms <your-APM>

빌드 서비스를 사용하지 않도록 설정하면 컨테이너 이미지를 통해서만 애플리케이션을 배포할 수 있습니다. 자세한 내용은 사용자 지정 컨테이너 이미지를 사용하여 애플리케이션 배포를 참조하세요.

Azure Spring Apps 엔터프라이즈의 여러 인스턴스를 사용할 수 있습니다. 이 경우 일부 인스턴스는 이미지를 빌드 및 배포하고 다른 인스턴스는 이미지만 배포합니다. 다음 시나리오를 살펴 보십시오.

한 인스턴스에서는 사용자 컨테이너 레지스트리를 사용하여 빌드 서비스를 사용하도록 설정합니다. 그런 다음 APM 또는 CA 인증서가 포함된 아티팩트 파일 또는 소스 코드에서 컨테이너 이미지로 빌드합니다. 그러면 현재 Azure Spring Apps 인스턴스 또는 다른 서비스 인스턴스에 배포할 수 있습니다. 자세한 내용은 Azure Spring Apps 엔터프라이즈에서 다국어 앱을 배포하는 방법의 다국어 애플리케이션 빌드 및 배포 섹션을 참조하세요.

빌드 서비스가 사용하지 않도록 설정된 다른 인스턴스에서는 레지스트리에 컨테이너 이미지가 포함된 애플리케이션을 배포하고 APM도 활용합니다.

이 시나리오에서는 다음 예제와 같이 전역적으로 사용하도록 설정된 APM 구성을 사용하거나 --apms 매개 변수를 사용하여 APM 구성을 지정할 수 있습니다.

az spring app deploy \
   --resource-group <resource-group-name> \
   --service <Azure-Spring-Apps-instance-name> \
   --name <app-name> \
   --container-image <your-container-image> \
   --container-registry <your-container-registry> \
   --registry-password <your-password> \
   --registry-username <your-username> \
   --apms <your-APM>

작성기의 바인딩을 통해 APM 관리(사용되지 않음)

빌드 서비스에서 Azure Spring Apps 관리형 컨테이너 레지스트리를 사용하는 경우 애플리케이션을 이미지에 빌드한 후 배포할 수 있지만, 현재 Azure Spring Apps 서비스 인스턴스 내에서만 배포할 수 있습니다.

작성기의 바인딩을 통해 APM 구성 관리

APM 구성은 작성기의 바인딩을 통해 관리할 수 있습니다. 자세한 내용은 Azure Spring Apps에서 작성기의 바인딩 관리(사용되지 않음) 섹션을 참조하세요.

앱 빌드 및 배포에 바인딩

다음 명령을 사용하여 APM을 배포에 통합합니다. APM은 작성기의 바인딩을 통해 구성됩니다.

az spring app deploy \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <app-name> \
    --builder <builder-name> \
    --artifact-path <path-to-your-JAR-file>

서비스 인스턴스를 만들 때 Application Insights를 사용하도록 설정

서비스 인스턴스를 만들 때 Application Insights를 사용하도록 설정하는 경우 적용되는 조건은 다음과 같습니다.

  • 관리형 Azure Container Registry를 빌드 서비스에 사용하는 경우 Application Insights는 기본 작성기의 바인딩에 바인딩됩니다.
  • 사용자 고유의 컨테이너 레지스트리를 빌드 서비스에 사용하거나 빌드 서비스를 사용하지 않도록 설정하는 경우 Application Insights에 대한 기본 APM 구성이 만들어집니다. 기본 APM은 전역적으로 사용하도록 설정되며 모든 후속 빌드 및 배포에서 자동으로 사용합니다.

앱 빌드 및 배포에 대한 CA 인증서 구성

CA 인증서는 Azure Spring Apps에서 다음 두 가지 방법으로 구성할 수 있습니다.

  • TLS/SSL 설정에서 퍼블릭 인증서를 관리하고 이러한 인증서를 참조하여 앱 빌드 및 배포에 바인딩할 수 있습니다. 이 방법은 CA 인증서를 구성하는 데 권장되는 방법입니다.
  • TLS/SSL 설정에서 퍼블릭 인증서를 관리하고 작성기의 바인딩을 통해 CA 인증서를 바인딩할 수 있습니다. 자세한 내용은 Azure Spring Apps에서 작성기의 바인딩 관리(사용되지 않음) 섹션을 참조하세요.

참고 항목

이 방법은 CA 인증서를 구성하는 이전 방법이며 더 이상 사용되지 않습니다. 바인딩에 구성된 CA 인증서를 마이그레이션하는 것이 좋습니다. 자세한 내용은 바인딩에 구성된 CA 인증서 마이그레이션 섹션을 참조하세요.

이제 TLS/SSL 설정에서 퍼블릭 인증서를 관리하고 이러한 인증서를 참조하여 앱 빌드 및 배포에 바인딩할 수 있습니다. 이 방법은 CA 인증서를 구성하는 데 권장되는 방법입니다.

서비스 인스턴스 수준에서 퍼블릭 인증서를 관리하려면 Azure Spring Apps에서 애플리케이션에 TLS/SSL 인증서 사용의 인증서 가져오기 섹션을 참조하세요. 그런 다음, 다음 섹션에서 설명하는 방법 중 하나를 따라 CA 인증서를 앱 빌드 및 배포에 바인딩합니다.

앱 빌드 및 배포에 CA 인증서 바인딩

CA 인증서를 배포에 바인딩하는 방법에 대한 자세한 내용은 Azure Spring Apps에서 애플리케이션에 TLS/SSL 인증서 사용의 인증서 로드 섹션을 참조하세요. 그런 다음, 다음 지침을 사용하여 앱 빌드에 바인딩합니다.

빌드 서비스를 사용하도록 설정하고 관리형 Azure Container Registry를 사용하는 경우 다음 명령을 사용하여 CA 인증서를 배포에 통합합니다.

az spring app deploy \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <app-name> \
    --builder <builder-name> \
    --build-certificates <CA certificate-name> \
    --artifact-path <path-to-your-JAR-file>

사용자 고유의 컨테이너 레지스트리를 빌드 서비스에 사용하거나 빌드 서비스를 사용하지 않도록 설정하는 경우 다음 명령을 사용하여 CA 인증서를 빌드에 통합합니다.

az spring build-service build <create|update> \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <app-name> \
    --builder <builder-name> \
    --certificates <CA certificate-name> \
    --artifact-path <path-to-your-JAR-file>

앱 빌드에 바인딩된 CA 인증서 보기

다음 단계를 수행하면 빌드에 바인딩된 CA 인증서를 확인할 수 있습니다.

  1. 빌드 페이지로 이동합니다.

    현재 빌드가 목록에 있는 빌드 서비스 페이지를 보여 주는 Azure Portal의 스크린샷.

  2. 탐색 창의 설정 섹션에서 인증서 바인딩을 선택합니다.

  3. 인증서 바인딩 페이지에서 빌드에 바인딩된 CA 인증서를 확인합니다.

    빌드에 바인딩된 CA 인증서를 보여 주는 인증서 바인딩 페이지의 스크린샷.

작성기의 바인딩을 통해 CA 인증서 바인딩(사용되지 않음)

CA 인증서는 ca-certificates 빌드팩을 사용하여 빌드 및 런타임 시 CA 인증서를 시스템 신뢰 저장소에 제공하도록 지원합니다.

Azure Spring Apps 엔터프라이즈 플랜에서 CA 인증서는 다음 스크린샷과 같이 Azure Portal의 TLS/SSL 설정 페이지에서 공개 키 인증서 탭을 사용합니다.

TLS/SSL 설정 페이지의 공개 키 인증서 섹션을 보여 주는 Azure Portal의 스크린샷.

바인딩 편집 페이지에서 CA 인증서를 구성할 수 있습니다. succeeded 인증서는 CA 인증서 목록에 표시됩니다.

CA 인증서에 대한 바인딩 편집 패널이 열려 있는 기본 작성기에 대한 바인딩 편집 페이지를 보여 주는 Azure Portal의 스크린샷.

Azure Spring Apps에서 작성기의 바인딩 관리(사용되지 않음)

이 섹션은 빌드 서비스가 사용하도록 설정된 Azure Spring Apps 엔터프라이즈 서비스 인스턴스에만 적용됩니다. 빌드 서비스가 사용하도록 설정된 경우 하나의 빌드팩 바인딩은 하나의 APM 형식에 대한 자격 증명 구성 또는 CA 인증서 유형에 대한 CA 인증서 구성을 의미합니다. APM 통합의 경우 이전 지침에 따라 APM에 필요한 환경 변수 또는 비밀을 구성합니다.

참고 항목

APM 바인딩에 대한 환경 변수를 구성할 때 접두사 없이 키 이름을 사용합니다. 예를 들어 Dynatrace 바인딩에 대한 DT_ 접두사 또는 Application Insights에 대한 APPLICATIONINSIGHTS_ 접두사는 사용하지 마세요. Tanzu APM 빌드팩은 키 이름을 접두사가 포함된 원래 환경 변수 이름으로 변환합니다.

빌드팩 바인딩은 Azure Portal 또는 Azure CLI를 사용하여 관리할 수 있습니다.

다음 단계를 수행하면 빌드팩 바인딩을 확인할 수 있습니다.

  1. Azure Portal에서 Azure Spring Apps 엔터프라이즈 서비스 인스턴스로 이동합니다.

  2. 탐색 창에서 빌드 서비스를 선택합니다.

  3. 바인딩 열 아래에서 편집을 선택하여 작성기에 대해 구성된 바인딩을 확인합니다.

    선택한 작성기의 바인딩 편집 링크가 강조 표시된 빌드 서비스 페이지를 보여 주는 Azure Portal의 스크린샷.

  4. 기본 작성기에 대한 바인딩 수정 페이지에서 바인딩을 검토합니다.

    바인딩 형식과 해당 상태가 나열된 기본 작성기의 바인딩 편집 페이지를 보여 주는 Azure Portal의 스크린샷.

빌드팩 바인딩 만들기

빌드팩 바인딩을 만들려면 바인딩 편집 페이지에서 바인딩 해제를 선택하고 바인딩 속성을 지정한 다음, 저장을 선택합니다.

빌드팩 바인딩 해제

바인딩 해제 명령을 사용하거나 바인딩 속성을 편집하여 빌드팩 바인딩을 바인딩 해제할 수 있습니다.

바인딩 해제 명령을 사용하려면 바인딩됨 하이퍼링크를 선택한 다음, 바인딩 해제를 선택합니다.

선택한 바인딩 형식에 대한 바인딩 해제 옵션이 강조 표시된 기본 작성기 페이지의 Azure Portal 바인딩 편집 스크린샷.

바인딩 속성을 편집하여 빌드팩 바인딩을 바인딩 해제하려면 바인딩 편집을 선택한 다음, 바인딩 해제를 선택합니다.

바인딩 해제 단추가 강조 표시된 바인딩 편집 페이지를 보여 주는 Azure Portal의 스크린샷.

바인딩을 해제하면 바인딩 상태가 바인딩됨에서 바인딩 해제됨으로 변경됩니다.

작성기의 바인딩에서 APM 및 CA 인증서 마이그레이션

작성기의 바인딩 기능은 더 이상 사용되지 않으며 나중에 제거될 예정입니다. 작성기에서 바인딩을 마이그레이션하는 것이 좋습니다.

바인딩에서 APM 및 CA 인증서를 구성하고 다음 섹션을 사용하여 마이그레이션할 수 있습니다.

바인딩에 구성된 APM 마이그레이션

대부분의 사용 사례에는 기본 작성기의 바인딩에 구성된 하나의 APM만 있습니다. 바인딩에서 동일한 구성을 사용하여 새 APM 구성을 만들고 이 APM 구성을 전역적으로 사용하도록 설정할 수 있습니다. 모든 후속 빌드 및 배포에서는 이 구성을 자동으로 사용합니다. 다음 단계를 수행하여 마이그레이션합니다.

  1. 다음 명령을 사용하여 APM 구성을 만듭니다.

    az spring apm create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <your-APM-name> \
    --type <your-APM-type> \
    --properties a=b c=d \
    --secrets e=f g=h

  2. 다음 명령을 사용하여 APM 구성을 전역적으로 사용하도록 설정합니다.

    az spring apm enable-globally \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <your-APM-name> \

  3. 다음 명령을 사용하여 전역적으로 사용하도록 설정된 새 APM 구성을 사용하도록 모든 애플리케이션을 다시 배포합니다.

    az spring app deploy \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <app-name> \
    --builder <builder-name> \
    --artifact-path <path-to-your-JAR-file>

  4. 새 APM 구성이 모든 애플리케이션에 대해 작동하는지 확인합니다. 모든 구성이 제대로 작동하면 다음 명령을 사용하여 작성기에서 APM 바인딩을 제거합니다.

    az spring build-service builder buildpack-binding delete \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <your-APM-buildpack-binding-name> \
    --builder-name <your-builder-name>

여러 바인딩에 APM이 여러 개 구성되어 있는 경우에는 여러 바인딩에서 구성이 동일한 APM 구성을 여러 개 만들고 해당하는 경우 APM 구성을 전역적으로 사용하도록 설정할 수 있습니다. 다음 명령과 같이 전역적으로 사용하도록 설정된 APM을 재정의하려면 --apms 매개 변수를 사용하여 배포에 대한 APM 구성을 지정합니다.

az spring app deploy \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <app-name> \
    --builder <builder-name> \
    --apms <APM-name> \
    --artifact-path <path-to-your-JAR-file>

마이그레이션 프로세스 중에 APM은 바인딩과 APM 구성 모두에서 구성됩니다. 이 경우 APM 구성이 적용되고 바인딩이 무시됩니다.

바인딩에 구성된 CA 인증서 마이그레이션

다음 단계를 수행하여 CA 인증서를 마이그레이션합니다.

  1. 바인딩에 구성된 CA 인증서의 경우 런타임에 사용되는 경우 해당 인증서를 애플리케이션에 로드할 수 있습니다. 자세한 내용은 Azure Spring Apps에서 애플리케이션에 TLS/SSL 인증서 사용의 인증서 로드 섹션을 참조하세요.

  2. 다음 명령을 사용하여 CA 인증서를 사용하는 모든 애플리케이션을 다시 배포합니다. 빌드 시 인증서를 사용하는 경우 --build-certificates 매개 변수를 사용하여 빌드 시 배포에 사용할 CA 인증서를 지정합니다.

    az spring app deploy \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <app-name> \
    --builder <builder-name> \
    --build-certificates <CA certificate-name> \
    --artifact-path <path-to-your-JAR-file>

  3. CA 인증서를 사용하는 모든 애플리케이션에 대해 해당 인증서가 작동하는지 확인합니다. 모든 인증서가 제대로 작동하면 다음 명령을 사용하여 작성기에서 CA 인증서 바인딩을 제거합니다.

    az spring build-service builder buildpack-binding delete \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <your-CA-certificate-buildpack-binding-name> \
    --builder-name <your-builder-name>

다음 단계