엔드포인트 릴리스 게시와 배포

게시하면 현재 엔드포인트 집합 설정의 불변 스냅샷을 의미적 버전으로 만듭니다. 배포하면 그 릴리스를 승인한 서브도메인에서 호출할 수 있습니다.

버전 만들기

집합의 Versions 탭에서 Endpoint set versions 표 오른쪽 위의 Tag and deploy new version을 선택합니다. 이 경로는 새 버전 게시와 배포를 함께 수행합니다.

게시만 하고 자동으로 배포하지 않으려면 Tag without deploying을 선택합니다. 이 경우 버전은 만들어지지만 해당 버전이 외부 호출 대상으로 제공되지는 않습니다.

호출 전 확인

• 도메인이 승인되어 Domain ready 상태인지 확인합니다.
• 사용할 릴리스가 게시뿐 아니라 배포까지 되었는지 확인합니다.
• 해당 버전의 경로, 메서드, 입력과 기반 함수/액션을 확인합니다.
• 시험할 사용자가 그 기반 작업을 수행할 권한이 있는지 확인합니다.

Versions에서 Deployed Version > Custom Endpoint를 선택하면 해당 버전의 설정과 cURL 예제를 볼 수 있습니다.

사용자 토큰으로 시험

사용자 생성 토큰을 안전한 환경 변수 또는 비밀 관리 경로로 준비합니다. FOUNDRY_TOKEN에는 실제 토큰, CUSTOM_ENDPOINT_URL에는 배포 화면에서 복사한 실제 URL, ENDPOINT_API_VERSION에는 배포한 버전을 제공합니다.

다음 예는 GET으로 구성한 조회 전용 함수와 JSON 응답을 전제로 합니다. 액션이나 쓰기 함수의 시험은 실제 데이터를 변경할 수 있습니다.

: "${FOUNDRY_TOKEN:?FOUNDRY_TOKEN must be supplied securely}"
: "${CUSTOM_ENDPOINT_URL:?CUSTOM_ENDPOINT_URL is required}"
: "${ENDPOINT_API_VERSION:?ENDPOINT_API_VERSION is required}"
curl --fail-with-body \
  --request GET \
  --header "Authorization: Bearer $FOUNDRY_TOKEN" \
  --header "endpoint-api-version: $ENDPOINT_API_VERSION" \
  "$CUSTOM_ENDPOINT_URL"

실제 엔드포인트가 다른 메서드나 본문을 요구하면 화면에서 제공한 cURL을 사용합니다. 토큰을 스크립트나 저장소에 문자열로 기록하지 않습니다. 호출 실패 시 배포 버전과 경로, 매개변수 매핑 및 사용자 권한을 확인합니다.

운영 앱은 사용자 생성 토큰 시험과 구분하여 Developer Console의 OAuth 앱을 사용합니다.

여러 버전 동시 제공

같은 서브도메인에 여러 릴리스를 배포할 수 있습니다. 예를 들어 beta, stable과 legacy 버전을 함께 제공하여 앱별 이전 시점을 달리할 수 있습니다.

호출할 버전은 endpoint-api-version 헤더로 선택합니다. 생략하면 최신 배포 버전을 사용하므로 새 배포에 따라 호출 대상이 바뀔 수 있습니다. 고정한 릴리스를 계속 사용하려면 그 릴리스가 배포된 상태인지와 요청 헤더를 함께 관리합니다.