Google Cloud Storage Locations
Backstage 카탈로그는 GCS(Google Cloud Storage) 버킷에 저장된 yaml 파일에서 엔티티를 가져올 수 있어요. 해당 엔티티의 수집을 활성화하려면 먼저 GoogleGcs 통합을 활성화해야 해요.
출처: 문서
본문
Backstage 카탈로그는 GCS(Google Cloud Storage) 버킷에 저장된 yaml 파일에서 엔티티를 가져올 수 있어요. 해당 엔티티의 수집을 활성화하려면 먼저 GoogleGcs 통합을 활성화해야 해요.
구성
통합을 구성하려면 적절한 자격 증명을 Backstage 백엔드에 추가하세요. 이를 수행하는 두 가지 주요 방법이 있어요. clientEmail과 privateKey를 명시적으로 설정하거나, Google Storage SDK가 자격 증명을 자동으로 발견하게 하는 거예요.
명시적 자격 증명
명시적 자격 증명은 다음 형식으로 설정할 수 있어요.
integrations: googleGcs: clientEmail: ${GCS_CLIENT_EMAIL} privateKey: ${GCS_PRIVATE_KEY}
그런 다음 Backstage를 실행할 때 환경 변수 GCS_CLIENT_EMAIL과 GCS_PRIVATE_KEY가 설정되어 있는지 확인하세요.
Google 자격 증명 자동 발견
이 통합은 Google Storage SDK를 사용하므로, 명시적 자격 증명을 제공하지 않고 SDK가 자동으로 발견하게 할 수도 있어요.
이 방법이 작동하려면 app-config.yaml의 integrations 섹션에 빈 googleGcs 객체를 추가해야 한다는 점 유의하세요.
integrations: googleGcs: {}
이런 발견 방법 중 하나는 GOOGLE_APPLICATION_CREDENTIALS라는 환경 변수를 제공하고, 그것을 JSON 서비스 계정 키의 파일 경로로 설정하는 거예요.
Google Storage SDK에 자격 증명을 제공하는 더 자세한 내용과 방법은 이 문서 페이지를 확인할 수 있어요.
사용법
이 통합을 사용해 GCS 버킷에서 엔티티를 가져오려면 Google 콘솔로 이동해 가져오고 싶은 파일을 찾아보세요. 그런 다음 Authenticated URL을 복사해 register component 양식의 텍스트 상자에 붙여넣으세요. 이 URL은 https://storage.cloud.google.com/<bucket>/<path>/catalog-info.yaml처럼 보일 거예요.