확장 프로그램 설치

Antigravity용 Google Cloud 데이터 에이전트 키트 확장 프로그램을 사용하면 원하는 IDE에서 Google Cloud 데이터 리소스를 사용할 수 있습니다.

시작하기 전에

Antigravity용 데이터 에이전트 키트 확장 프로그램을 설치하기 전에 다음을 실행합니다.

Antigravity 및 Python 설치

로컬 머신에 Antigravity와 Python을 설치합니다.

  1. 머신에 Antigravity를 설치하고 설정하거나 버전 1.21.5 이상으로 업데이트합니다.
  2. Python을 설치합니다.

Google Cloud설정

  1. 아직 프로젝트가 없으면 Google Cloud 프로젝트를 만듭니다.
  2. 결제 사용 설정

gcloud CLI 설치

Google Cloud CLI를 설치하고 로그인해야 합니다. 확장 프로그램은 gcloud CLI와 애플리케이션 기본 사용자 인증 정보 (ADC)의 사용자 인증 정보를 모두 사용합니다.

  1. 로컬 머신 또는 Antigravity에서 터미널을 엽니다.
  2. 이전에 gcloud CLI를 설치하지 않은 경우 gcloud CLI 설치의 단계에 따라 gcloud CLI를 다운로드하고 설치합니다.
  3. 터미널에서 gcloud init를 실행하여 gcloud CLI를 초기화합니다.

    gcloud init
    
  4. 다음 명령어를 실행하고 안내에 따라 인증하고 애플리케이션 기본 사용자 인증 정보를 설정합니다.

    gcloud auth login && gcloud auth application-default login
    
  5. gcloud CLI를 최신 버전으로 업데이트합니다.

    gcloud components update
    

필요한 역할

Antigravity용 데이터 에이전트 키트 확장 프로그램을 사용하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 다음 Identity and Access Management (IAM) 역할을 부여해 달라고 요청하세요. 자세한 내용은 필요한 역할 검토하기를 참고하세요.

사용 사례에 따라 추가 역할이 필요할 수 있지만 이러한 역할을 사용하면 확장 프로그램을 설치하고 설정할 수 있습니다. 전체 목록은 IDE 확장 프로그램 설정에서 확인할 수 있습니다.

  • BigQuery 데이터 뷰어(roles/bigquery.dataViewer)
  • BigQuery 작업 사용자(roles/bigquery.jobUser)
  • BigQuery 메타데이터 뷰어(roles/bigquery.metadataViewer)
  • BigQuery 읽기 세션 사용자(roles/bigquery.readSessionUser)
  • Dataproc 편집자 (roles/dataproc.editor)

역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참고하세요.

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

사전 정의된 역할에는 확장 프로그램을 사용하는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 확장하세요.

필수 권한

  • bigquery.config.get
  • bigquery.datasets.get
  • bigquery.datasets.getIamPolicy
  • bigquery.jobs.create
  • bigquery.readsessions.create
  • bigquery.readsessions.getData
  • bigquery.readsessions.update
  • bigquery.tables.createSnapshot
  • bigquery.tables.export
  • bigquery.tables.get
  • bigquery.tables.getIamPolicy
  • bigquery.tables.list
  • bigquery.tables.replicateData
  • dataform.locations.get
  • dataform.locations.list
  • dataform.repositories.create
  • dataform.repositories.list
  • dataplex.projects.search
  • dataproc.clusters.use
  • dataproc.operations.get
  • dataproc.sessions.create
  • dataproc.sessions.delete
  • dataproc.sessions.get
  • dataproc.sessions.list
  • dataproc.sessions.terminate
  • dataproc.sessionTemplates.create
  • dataproc.sessionTemplates.delete
  • dataproc.sessionTemplates.get
  • dataproc.sessionTemplates.list
  • dataproc.sessionTemplates.update
  • resourcemanager.projects.get

확장 프로그램 설치

  1. Antigravity에서 확장 프로그램을 클릭하거나 Ctrl/Cmd+Shift+X을 누릅니다.
  2. Google Cloud Data Agent Kit을 검색합니다.
  3. 설치를 클릭합니다.
  4. 메시지가 표시되면 Antigravity를 다시 시작합니다. 확장 프로그램이 설치되면 Google Cloud 데이터 에이전트 키트 아이콘이 작업 표시줄에 추가됩니다.

Google Cloud Data Agent Kit에 로그인

그런 다음 gcloud CLI에 로그인하는 데 사용한 계정과 동일한 계정을 사용하여 Google Cloud Data Agent Kit에 인증해야 합니다.

  1. 로그인 대화상자가 자동으로 열리지 않으면 IDE 창 하단 근처의 상태 표시줄에서 Google Cloud Data Agent Kit 로그인 링크를 찾아 클릭합니다.

    또는 Ctrl/Cmd+Shift+P 키를 눌러 명령어 팔레트를 열고 Google Cloud 데이터 에이전트 키트: 로그인을 검색하여 선택할 수 있습니다.

  2. 표시되는 메시지에 따라 로그인을 완료합니다.

    인증이 완료되었음을 확인하는 웹페이지가 표시됩니다.

  3. 페이지를 닫고 IDE로 돌아갑니다.

API 사용 설정

Google 계정에 로그인한 후 데이터 과학 또는 데이터 엔지니어링 워크플로에 사용하는 모든 서비스에 대해Google Cloud 프로젝트에서 API를 사용 설정해야 합니다.

API 목록을 확인하고 이미 사용 설정된 API를 확인하려면 다음 단계를 따르세요.

  1. 작업 표시줄에서 Google Cloud Data Agent Kit 아이콘을 클릭합니다.
  2. 설정을 펼친 다음 설정을 클릭합니다.
  3. Common(일반)을 선택합니다.
  4. 필수 API를 클릭합니다.

사용 설정할 API

  • AlloyDB API
  • BigLake API
  • BigQuery API
  • Cloud Composer API
  • Cloud Dataplex API
  • Cloud Resource Manager API
  • Cloud Spanner API
  • Cloud SQL
  • Cloud SQL Admin API
  • Cloud Storage API
  • Dataproc API
  • Dataproc Release Manager API
  • Vertex AI API

문제 해결

문제가 발생하면 Google Cloud Data Agent Kit 및 gcloud CLI에서 로그아웃한 후 다시 로그인해 보세요. 설치 오류를 진단하고 해결하는 추가 방법을 알아보려면 Antigravity용 데이터 에이전트 키트 확장 프로그램 문제 해결을 참고하세요.

다음 단계