기본 요건

이 페이지에서는 Cortex Framework 배포 기본 요건을 안내합니다. 데모 배포 또는 프로덕션 배포로 진행하기 전에 각 기본 요건을 구성하는 데 시간을 할애하세요.

설치 아티팩트

Google Cloud Cortex Framework 저장소를 클론합니다. https://github.com/GoogleCloudPlatform/cortex-framework:

git clone https://github.com/GoogleCloudPlatform/cortex-framework

저장소가 클론된 폴더로 디렉터리를 변경합니다.

cd DIRECTORY

uv 설치

uv 는 Rust로 작성된 매우 빠른 Python 패키지 관리자입니다. Cortex Framework는 이를 사용하여 일관되고, 격리된 고성능 빌드 배포 환경을 만들고 설치 시간을 단축합니다.

Python 가상 환경용 관리자 패키지 uv를 설치합니다. uv 설치 안내를 참조하세요.

필수 종속 항목 동기화

종속 항목 동기화 및 Python 가상 환경 활성화를 위해 다음 명령어를 실행합니다.

uv sync

Google Cloud SDK 명령줄 인터페이스 구성

gcloud auth login
gcloud auth application-default login

Dataform 호스팅을 위한 Google Cloud 프로젝트 준비

배포를 실행하기 전에 연결된 결제 계정이 있는 Google Cloud 프로젝트에 액세스할 수 있어야 합니다.

다음으로 Google Cloud CLI 환경을 구성하여 특정 Google Cloud 프로젝트를 가리킵니다.

# Set current project and quota project
gcloud config set project PROJECT_ID
gcloud auth application-default set-quota-project PROJECT_ID

서비스 사용 설정 Google Cloud

이 섹션에서는 프로젝트에서 다음 Google Cloud 서비스를 사용 설정합니다 Google Cloud .

  • BigQuery API
  • Dataform API
  • Cloud Resource Manager API

터미널에서 다음 명령어를 실행하여 Cloud Shell을 사용하여 이러한 서비스 Google Cloud 를 사용 설정합니다.

PROJECT_ID를 프로젝트 ID로 바꿉니다.

gcloud config set project PROJECT_ID

gcloud services enable cloudresourcemanager.googleapis.com \
                       bigquery.googleapis.com \
                       dataform.googleapis.com \
                       --project=PROJECT_ID

다음 단계

빌드 및 배포할 준비가 되셨나요? 다음 가이드를 살펴보고 배포를 시작하고 실행하세요.

  • 데모 배포: 몇 분 안에 샘플 데이터를 배포하여 Cortex Framework가 작동하는지 확인합니다.
  • 프로덕션 배포: 단계별 안내에 따라 엔터프라이즈 데이터용 Cortex Framework를 구성하고 배포합니다.