Prasyarat

Halaman ini memandu Anda melalui prasyarat deployment Cortex Framework. Luangkan waktu untuk mengonfigurasi setiap prasyarat sebelum melanjutkan ke deployment Demo atau deployment Produksi.

Artefak penginstalan

Clone repositori Google Cloud Cortex Framework: https://github.com/GoogleCloudPlatform/cortex-framework:

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

Ubah direktori ke folder tempat repositori di-clone:

cd DIRECTORY

Menginstal uv

uv adalah pengelola paket Python yang sangat cepat, yang ditulis dalam Rust. Cortex Framework menggunakannya untuk memiliki lingkungan deployment build yang konsisten, terisolasi, dan berperforma tinggi serta mengurangi waktu penginstalan.

Catatan: Jika Anda menjalankan perintah ini dari Cloud Shell, uv sudah diinstal dan Anda dapat melewati langkah penginstalan

Instal paket pengelola uv untuk lingkungan virtual Python. Lihat petunjuk penginstalan uv.

Menyinkronkan dependensi yang diperlukan

Jalankan perintah berikut untuk sinkronisasi dependensi dan untuk aktivasi lingkungan virtual Python:

uv sync

Mengonfigurasi antarmuka command line Google Cloud SDK

Catatan: Jika Anda menjalankan perintah gcloud untuk pertama kalinya di lingkungan lokal, atau jika Anda mengalami masalah autentikasi, gunakan perintah ini untuk memastikan autentikasi Google Cloud SDK.

gcloud auth login
gcloud auth application-default login

Menyiapkan Google Cloud project untuk hosting Dataform

Sebelum menjalankan deployment, Anda harus memiliki akses ke Google Cloud project dengan akun penagihan terlampir.

Catatan: Project ini digunakan sebagai project default untuk menjalankan perintah gcloud dan untuk menghosting repositori Dataform. Project ini tidak otomatis digunakan sebagai project target dalam deployment Cortex Framework itu sendiri. Project deployment (seperti project build, sumber, dan target) dikonfigurasi secara terpisah dalam penyiapan deployment Anda (misalnya, dalam file config/config.yaml).

Selanjutnya, konfigurasikan lingkungan Google Cloud CLI untuk mengarah ke project tertentu Google Cloud .

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

Mengaktifkan Google Cloud layanan

Di bagian ini, kita akan mengaktifkanlayanan berikut di Google Cloud project Anda: Google Cloud

• BigQuery API
• Dataform API
• Cloud Resource Manager API

Aktifkanlayanan ini menggunakan Cloud Shell dengan menjalankan perintah berikut di terminal Anda: Google Cloud

Ganti PROJECT_ID dengan project ID Anda.

gcloud config set project PROJECT_ID

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

Langkah berikutnya

Siap membangun dan men-deploy? Pelajari panduan berikut untuk menyiapkan dan menjalankan deployment Anda:

• Demo deployment: Deploy contoh data dalam hitungan menit untuk melihat Cortex Framework beraksi.
• Deployment produksi: Ikuti petunjuk langkah demi langkah untuk mengonfigurasi dan men-deploy Cortex Framework untuk data perusahaan Anda.