다음을 통해 공유


Azure Spring Apps Enterprise 계획에서 작업 관리 및 사용

참고 항목

기본, 표준엔터프라이즈 계획은 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 Enterprise 계획에서 실행하는 방법을 보여줍니다.

필수 조건

작업 만들기 및 배포

다음 명령을 사용하여 작업을 만들고 배포합니다.

az spring job create --name <job-name>
az spring job deploy \
    --name <job-name> \
    --artifact-path <artifact-path>

공개 미리 보기의 경우 서비스 인스턴스당 최대 10개의 작업을 만들 수 있습니다.

작업 실행 시작 및 취소

다음 명령을 사용하여 작업 실행을 시작합니다.

az spring job start --name <job-name>

명령이 성공적으로 실행되면 작업 실행의 이름을 반환합니다. 매개 변수를 --wait-until-finished true 사용하면 작업 실행이 완료될 때까지 명령이 반환되지 않습니다.

작업 실행 상태를 쿼리하려면 다음 명령을 사용합니다. <execution-name> 시작 명령에서 반환된 이름으로 바꿉습니다.

az spring job execution show \
    --job <job-name> \
    --name <execution-name>

실행 중인 작업 실행을 취소하려면 다음 명령을 사용합니다.

az spring job execution cancel \
    --job <job-name> \
    --name <execution-name>

쿼리 작업 실행 기록

실행 기록을 표시하려면 다음 명령을 사용합니다.

az spring job execution list --job <job-name>

공개 미리 보기의 경우 작업당 최근 10개의 완료되거나 실패한 작업 실행 레코드가 기록에 유지됩니다.

작업 실행 로그 쿼리

Azure Portal에서 작업 실행 기록을 얻으려면 다음 Log Analytics 쿼리를 사용합니다.

AppPlatformLogsforSpring
| where AppName == '<job-name>' and InstanceName startswith '<execution-name>'
| order by TimeGenerated asc

자세한 내용은 빠른 시작: Log Analytics 작업 영역 설정을 참조하세요.

실시간 로그의 경우 명령줄에서 다음 명령을 사용합니다.

az spring job logs \
    --name <job-name> \
    --execution <execution-name>

작업 실행에 대한 인스턴스가 여러 개 있는 경우 하나의 인스턴스에 대해서만 로그를 보도록 지정 --instance <instance-name> 합니다.

작업 실행 다시 실행

다음 명령을 사용하여 새 작업 실행을 트리거합니다.

az spring job start \
    --name <job-name> \
    --args <argument-value> \
    --envs <key=value>

관리되는 구성 요소와 통합

공개 미리 보기의 경우 작업은 효율적인 구성 관리를 위해 Spring Cloud Config Server와 원활하게 통합되고 서비스 검색을 위한 Tanzu Service Registry를 사용할 수 있습니다.

Spring Cloud Config Server와 통합

Spring Cloud Config Server를 사용하면 Git 리포지토리의 작업에 필요한 구성 또는 속성을 관리한 다음 작업에 로드할 수 있습니다. Spring Cloud Config Server에 대한 Git 리포지토리 구성을 설정한 후에는 작업을 서버에 바인딩해야 합니다.

다음 명령을 사용하여 작업을 만드는 동안 Spring Cloud Config Server에 작업을 바인딩합니다.

az spring job create \
    --name <job-name> \
    --bind-config-server true

기존 작업의 경우 다음 명령을 사용하여 Spring Cloud Config Server에 바인딩합니다.

az spring config-server bind --job <job-name>

작업에 Spring Cloud Config Server가 더 이상 필요하지 않은 경우 해당 서버에서 바인딩을 해제할 수 있습니다. 이 변경 내용은 새 작업 실행에 적용됩니다.

다음 명령을 사용하여 작업을 바인딩 해제합니다.

az spring config-server unbind --job <job-name>

Tanzu 서비스 레지스트리와 통합

작업은 정보, 알림 등을 쿼리하기 위해 공동 작업에서 장기 실행 앱에서 API를 호출하는 것이 일반적입니다. 작업이 동일한 Azure Spring Apps 서비스에서 실행되는 앱을 검색할 수 있도록 하려면 앱과 작업을 모두 관리되는 서비스 레지스트리에 바인딩할 수 있습니다. 다음 섹션에서는 Tanzu 서비스 레지스트리에 작업을 바인딩하는 방법을 설명합니다.

다음 명령을 사용하여 작업을 만드는 동안 Tanzu 서비스 레지스트리에 작업을 바인딩합니다.

az spring job create --bind-service-registry true

기존 작업의 경우 다음 명령을 사용하여 Tanzu 서비스 레지스트리에 바인딩합니다.

az spring service-registry bind --job <job-name>

작업 실행을 실행하면 서비스 레지스트리를 통해 등록된 앱의 엔드포인트에 액세스할 수 있습니다.

작업에 대한 서비스 레지스트리가 더 이상 필요하지 않은 경우 해당 레지스트리에서 바인딩을 해제할 수 있습니다. 이 변경 내용은 새 작업 실행에 적용됩니다.

다음 명령을 사용하여 작업을 바인딩 해제합니다.

az spring service-registry unbind --job <job-name>

참고 항목

Azure Spring Apps의 작업