적용 대상: 기본 | 표준 | 프리미엄
이 문서에서는 API Management 인스턴스에서 서비스 업데이트 설정(미리 보기)을 구성하는 방법을 보여 줍니다. Azure는 단계적 롤아웃 방법을 사용하여 API Management 인스턴스에 서비스 업데이트를 주기적으로 적용합니다. 이러한 업데이트에는 새로운 기능, 보안 향상 및 안정성 향상이 포함됩니다.
Azure에서 각 API Management 인스턴스를 업데이트하는 시기를 정확하게 제어할 수는 없지만, 일부 서비스 계층에서는 업데이트 배포 중보다 이전 또는 나중에 업데이트를 받도록 인스턴스에 대한 업데이트 그룹 ( 릴리스 채널이라고도 함)을 선택할 수 있습니다. 인스턴스가 업데이트를 받도록 하려는 요일 동안 유지 관리 기간을 구성할 수도 있습니다.
업데이트 그룹 - 프로덕션 롤아웃 중에 API Management 서비스 업데이트를 수신하는 인스턴스 집합으로, 완료하는 데 며칠에서 몇 주가 걸릴 수 있습니다.
다음 중에서 선택합니다.
- 초기 - 새 기능에 대한 테스트 및 조기 액세스를 위해 출시 초기에 업데이트를 받습니다. 이 옵션은 프로덕션 배포에는 권장되지 않습니다.
- 기본값 - 정기 릴리스 출시의 일부로 업데이트를 받습니다. 이 옵션은 프로덕션 배포를 포함한 대부분의 서비스에 권장됩니다.
- 지연 - 이전 그룹보다 늦게 업데이트를 받습니다(일반적으로 초기 출시 후 몇 주 후). 이 옵션은 중요 업무용 배포에만 권장됩니다.
- AI Gateway Early (GenAI 릴리스 채널) - 다른 업데이트 그룹에 도달하기 전에 최신 AI 게이트웨이 기능 및 업데이트 에 대한 초기 액세스를 가져옵니다. 늦은 출시 그룹의 일부로 다른 서비스 업데이트를 받습니다.
비고
Azure는 SDP(안전한 배포 사례) 프레임워크를 사용하여 모든 업데이트를 배포합니다. 출시 초기에 릴리스된 업데이트는 안정성이 떨어지고 나중에 안정적인 릴리스로 대체될 수 있습니다. 모든 인스턴스는 결국 가장 안정적인 릴리스 빌드로 업데이트됩니다.
예를 들어 초기 업데이트 그룹에 테스트 인스턴스를 추가할 수 있습니다. 이 인스턴스는 기본 또는 지연 업데이트 그룹에 배치한 프로덕션 인스턴스 이전에 업데이트를 받습니다. 테스트 인스턴스가 프로덕션 인스턴스에 도달하기 전에 업데이트로 인한 문제를 모니터링할 수 있습니다. API Management를 사용하는 카나리아 배포에 대해 자세히 알아보기
유지 관리 기간 - 인스턴스가 업데이트를 받도록 할 때 매일 8시간입니다. 기본적으로 유지 관리 기간은 인스턴스의 표준 시간대에서 오후 10시부터 오전 6시까지입니다.
업데이트 중에 서비스 중단은 드물지만 서비스 사용량이 적은 시간을 선택하여 위험을 줄일 수 있습니다. 예를 들어 프로덕션 인스턴스의 경우 평일 저녁과 주말 아침에 유지 관리 기간을 설정합니다.
서비스 업데이트 설정 구성
- Azure Portal에 로그인하고 API Management 인스턴스로 이동합니다.
- 왼쪽 메뉴에서 배포 + 인프라>서비스 업데이트 설정을 선택합니다.
- 업데이트 그룹에서 현재 설정을 검토하고 편집을 선택하여 변경합니다.
- 유지 관리 기간에서 현재 설정을 검토하고 편집을 선택하여 변경합니다. 매일 기본 창, 다른 표준 창 또는 사용자 지정 창을 매일 선택할 수 있습니다.
인스턴스에서 업데이트를 받는 시기 파악
예상되거나 진행 중인 서비스 업데이트에 대해 알아보는 방법은 다음과 같습니다.
API Management 업데이트는 API Management GitHub 리포지토리에 발표됩니다. 업데이트 롤아웃이 시작되는 시기를 알 수 있도록 이 리포지토리에서 알림을 수신하도록 구독합니다.
Azure 활동 로그를 사용하여 API Management 인스턴스에서 발생하는 서비스 업데이트를 모니터링합니다. "예약된 유지 관리" 이벤트는 업데이트가 시작될 때 내보내집니다.
알림을 자동으로 받으려면 활동 로그에 경고를 설정합니다 .
기본적으로 업데이트는 Azure EUAP 지역, 미국 중서부, 이후 여러 단계에서 나머지 지역으로 배포됩니다. 이후 배포 단계에서 업데이트된 지역 시퀀스는 서비스마다 다릅니다. 프로덕션 출시의 각 단계 사이에 최소 24시간이 소요될 수 있습니다.
지역 내에서 프리미엄 계층의 API Management 인스턴스는 다른 서비스 계층의 인스턴스보다 몇 시간 후에 업데이트를 받습니다.
팁 (조언)
API Management 인스턴스가 여러 위치(지역)에 배포되는 경우 업데이트 시기는 인스턴스의 기본 위치에 따라 결정됩니다.
카나리아 배포 전략
특정 업데이트 그룹에 할당되거나(해당 옵션을 사용할 수 있는 경우) 특정 Azure 지역에 배포된 API Management 인스턴스를 프로덕션 인스턴스보다 일찍 업데이트를 수신하는 카나리아 배포로 사용할 수 있습니다.
초기 업데이트 그룹에 인스턴스 추가 - 초기 업데이트 그룹의 API Management 인스턴스를 사용하여 프로덕션 롤아웃 초기에 업데이트의 유효성을 검사합니다. 이 인스턴스는 사실상 카나리아 배포입니다.
카나리아 지역에 배포 - Azure EUAP 지역에 액세스할 수 있는 경우 프로덕션 파이프라인에 릴리스되는 즉시 인스턴스를 사용하여 업데이트의 유효성을 검사합니다. Azure 지역 액세스 요청 프로세스에 대해 알아봅니다.
비고
EUAP 지역의 용량 제약 조건으로 인해 필요에 따라 API Management 인스턴스의 크기를 조정하지 못할 수 있습니다.
파일럿 지역에 배포 - 미국 중서부의 인스턴스를 사용하여 프로덕션 환경을 시뮬레이션하거나 비임계 API 트래픽에 프로덕션에서 사용합니다. 이 지역은 EUAP 지역 이후에 업데이트를 수신하지만, 그곳에서의 배포는 서비스 구성에 특정한 회귀를 식별할 가능성이 더 높습니다.
지역에 중복 인스턴스 배포 - 프로덕션 워크로드가 특정 지역의 프리미엄 계층 인스턴스인 경우 이전에 업데이트를 수신하는 하위 계층에 유사하게 구성된 인스턴스를 배포하는 것이 좋습니다. 예를 들어 업데이트의 유효성을 검사하도록 개발자 계층에서 사전 프로덕션 인스턴스를 구성합니다.
관련 콘텐츠
- API Management 인스턴스 를 모니터링하는 방법을 알아봅니다.
- API Management 인스턴스를 관찰 하는 다른 옵션에 대해 알아봅니다.