이 페이지에서는 Cloud Life Sciences API를 사용하는 데 필요한 설정 단계를 안내합니다.
(빠른 시작을 완료한 경우 이미 이 단계 중 일부를 수행한 것입니다. 이 페이지를 검토하여 Cloud Life Sciences API를 사용할 준비가 되었는지 확인하세요.)
시작하기 전에
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Cloud Life Sciences API.
- Cloud Life Sciences Service Agent라는 서비스 계정이 생성됩니다.
- 이 서비스 계정에는 기본 역할
lifesciences.workflowsRunner
가 자동으로 할당됩니다. 이 역할을 사용하면 프로젝트 내에서 Compute Engine 인스턴스를 시작하고 중지할 수 있습니다. - API를 사용하여 파이프라인을 실행하려고 하면 권한 오류가 발생합니다. 이 문제를 해결하려면 문제 해결을 참조하세요.
- 또한 API는 파이프라인이 완료될 때 실행 중인 인스턴스를 종료할 수 없으며 이러한 리소스에 대한 요금이 계속 청구됩니다. 이 문제를 해결하려면 문제 해결을 참조하세요.
SDK를 초기화한 후 Cloud Life Sciences 구성요소를 설치합니다.
gcloud components update beta
gcloud CLI가 기본 설치된 Compute Engine VM을 사용하는 경우 이전 명령어를 사용하여 구성요소를 설치할 수 없습니다. Compute Engine VM에서 Cloud Life Sciences API를 사용 설정하려면 다음 명령어를 실행하여 gcloud CLI를 다시 설치합니다.
sudo apt-get remove google-cloud-sdk curl https://sdk.cloud.google.com | bash exec -l $SHELL gcloud init
- Cloud Life Sciences GitHub 저장소의 코드 샘플
- Cloud Life Sciences API에 직접 액세스하는 Google Cloud CLI 이외의 도구
Google Cloud 콘솔에서 사용자 인증 정보 페이지로 이동합니다.
사용자 인증 정보 만들기 > 서비스 계정을 클릭합니다.
서비스 계정 세부정보 페이지에서 서비스 계정 이름을 입력한 후 만들기를 클릭합니다.
이 서비스 계정에 프로젝트에 대한 액세스 권한 부여 탭에서 서비스 계정의 역할을 선택합니다. Cloud Life Sciences를 최대한 사용하려면 Cloud Life Sciences > Cloud Life Sciences 워크플로 실행자를 선택한 다음 계속을 클릭합니다.
선택사항: 사용자에게 이 서비스 계정에 대한 액세스 권한 부여 탭을 작성합니다.
완료를 클릭합니다.
Google Cloud 콘솔에서 서비스 계정 페이지로 이동합니다.
키를 만들 서비스 계정의 행을 찾습니다. 해당 행에서
를 클릭한 후 키 관리를 클릭합니다.키 페이지에서 키 추가를 클릭한 후 새 키 만들기를 클릭합니다.
키 유형으로 JSON을 선택하고 만들기를 클릭합니다.
- BigQuery로 변이 분석
- Cloud Storage 및 BigQuery에서 변이 저장 및 로드
- Cloud Life Sciences API로 파이프라인을 실행하는 방법에 대한 가이드 보기
서비스 계정 및 기본 역할 이해
gcloud CLI 또는 RPC 및 REST API를 사용해서 파이프라인을 처음 실행할 때는 다음 인증 단계가 수행됩니다.
나중에 해당 프로젝트 서비스 계정에서 기본 역할을 제거하면 다음과 같은 오류가 발생할 수 있습니다.
Google Cloud CLI 및 Google Cloud CLI 설정
Google Cloud CLI를 설치하여 Cloud Life Sciences, Compute Engine, Cloud Storage, BigQuery에서 도구와 라이브러리를 사용합니다. SDK에는 gcloud
, gsutil
, bq
명령줄 도구가 포함되어 있습니다.
API 액세스를 위한 사용자 인증 정보 다운로드
다음 방법 중 하나를 사용해서 Cloud Life Sciences API에 액세스하려는 경우 프로젝트에 대해 서비스 계정 키 파일을 다운로드해야 합니다.
서비스 계정 키 파일을 만들려면 다음 단계를 완료합니다.
서비스 계정 키를 다운로드하려면 다음 단계를 따르세요.
만들기를 클릭하면 서비스 계정 키 파일이 다운로드됩니다. 이 파일은 서비스 계정으로 인증하는 데 사용할 수 있으므로 안전하게 저장해야 합니다. 이 파일을 이동하고 이름을 변경할 수 있습니다.