Skip to main content
이 새로운 기능을 사용하면 게임 개발자는 계측 키 및 비밀 키와 같은 시크릿을 게임 서버에 안전하게 업로드, 나열, 업데이트 및 사용할 수 있습니다.

시크릿 관리 기능 사용 방법

시크릿을 효과적으로 관리하고 활용하기 위해 권장하는 워크플로우는 다음과 같습니다:
  1. 시크릿 추가(이 단계는 여러 시크릿에 대해 반복될 수 있음)
  2. 새 빌드를 생성할 때 시크릿을 이름으로 참조
  3. 게임 서버에서 시크릿 액세스
  4. 필요에 따라 시크릿 업데이트

시크릿 추가

UploadSecret API를 통해 시크릿을 추가할 수 있습니다. 이 API를 사용하면 새 시크릿을 서비스에 업로드하거나 ForceUpdate 파라미터를 true로 설정하여 기존 시크릿을 업데이트할 수 있습니다.

시크릿 배포

새로 생성된 VM에 시크릿을 배포하려면 CreateBuild API의 GameSecretReferences 파라미터를 사용하여 빌드에 시크릿을 통합하세요(컨테이너 및 프로세스 기반 배포에 모두 적용 가능).
빌드가 생성된 후에는 새 시크릿을 추가할 수 없지만, 기존 시크릿을 업데이트하면 새 VM에서 업데이트된 값을 사용할 수 있습니다(기존 VM은 원래 값을 유지).
시크릿을 참조하는 방법의 예는 다음과 같습니다:

시크릿 액세스

시크릿이 새 빌드에 추가되고 참조되면 게임 서버는 컨테이너 기반이든 프로세스 기반이든 각 게임 서버 내의 환경 변수를 통해 이러한 시크릿 값에 액세스할 수 있습니다. 환경 변수의 명명 규칙은 다음과 같습니다:

시크릿 삭제

이전 시크릿을 제거하려면 DeleteSecret API를 활용하세요. 삭제하려는 시크릿이 어떤 빌드에서도 사용되고 있지 않은지 확인하세요. 그렇지 않으면 삭제가 성공하지 않습니다.

VM 시작 스크립트에서 시크릿 사용

VM 시작 스크립트는 설명된 대로 환경 변수를 참조하여 시크릿 값을 활용할 수 있습니다. 이를 통해 게임 서버를 시작하기 전에 원격 측정 키 또는 기타 필요한 값을 사용할 수 있습니다.

참고 항목

마지막 수정일 2026년 8월 25일