Menyiapkan project untuk Vertex AI

Untuk menjalankan layanan Vertex AI di Google Distributed Cloud (GDC) dengan air gap, siapkan project khusus dan konfigurasi lingkungan pengembangan Anda. Siapkan gdcloud CLI dan akun layanan agar Anda dapat mengintegrasikan machine learning ke dalam aplikasi dan alur kerja yang di-air-gap.

Dokumen ini ditujukan untuk developer aplikasi dalam grup operator aplikasi yang mengoptimalkan aplikasi dan alur kerja air-gapped dengan fitur AI. Untuk mengetahui informasi selengkapnya, lihat Audiens untuk dokumentasi GDC dengan air gap.

Meminta administrator menyiapkan project untuk Anda

Sebagian besar tugas untuk menyiapkan project memerlukan akses administrator platform. Administrator harus menentukan nama project dan project ID yang bermakna untuk mengidentifikasi project. Jika Anda adalah bagian dari organisasi atau berencana membuat beberapa project, pertimbangkan konvensi penamaan dan entity yang dikenali di Distributed Cloud. Untuk mengetahui informasi selengkapnya, lihat Hierarki resource.

Jika Anda tidak memiliki izin yang diperlukan, minta administrator untuk menyiapkan project atas nama Anda.

Siapkan project dengan mengikuti petunjuk dalam dokumen ini.

Sebelum memulai

Untuk mendapatkan izin yang diperlukan untuk membuat project dan mengonfigurasi akun layanan, minta IAM Org Admin atau IAM Project Admin untuk memberi Anda peran berikut di namespace project Anda:

  • Untuk membuat project, dapatkan peran Project Creator (project-creator).
  • Untuk membuat akun layanan, dapatkan peran Admin Project IAM (project-iam-admin).

Untuk mengetahui informasi tentang peran ini, lihat Menyiapkan izin IAM. Untuk mempelajari cara memberikan izin kepada subjek, lihat Memberikan dan mencabut akses.

Kemudian, buat project untuk mengelompokkan layanan Vertex AI Anda. Pastikan penagihan diaktifkan untuk project Distributed Cloud Anda.

Menginstal gdcloud CLI

Untuk mengaktifkan layanan Distributed Cloud dan mendapatkan akses ke alat dan komponen, instal gdcloud CLI.

Ikuti langkah-langkah berikut untuk menginstal gdcloud CLI:

  1. Download gdcloud CLI.

  2. Lakukan inisialisasi gdcloud CLI:

    gdcloud init

    Untuk mengetahui informasi selengkapnya, lihat Menginstal gdcloud CLI.

  3. Melakukan autentikasi dengan gdcloud CLI:

    gdcloud auth login

    Untuk mengetahui informasi selengkapnya tentang cara melakukan autentikasi dengan penyedia identitas yang dikonfigurasi dan mendapatkan file kubeconfig untuk identitas pengguna dan cluster Kubernetes, lihat autentikasi gdcloud CLI.

Menyiapkan akun layanan

Akun layanan, yang juga disebut sebagai identitas layanan, memainkan peran penting dalam mengelola layanan Vertex AI Anda. Akun ini adalah akun yang digunakan workload Anda untuk mengakses layanan Vertex AI dan model AI serta melakukan panggilan API yang diizinkan secara terprogram. Misalnya, akun layanan dapat mengelola notebook Vertex AI Workbench Anda untuk mentranskripsikan file audio menggunakan Speech-to-Text API. Serupa dengan akun pengguna, akun layanan dapat diberi izin dan peran, sehingga menyediakan lingkungan yang aman dan terkontrol, tetapi tidak dapat login seperti pengguna manusia.

Anda dapat menyiapkan akun layanan untuk layanan Vertex AI dengan menentukan nama akun layanan, project ID, dan nama file JSON untuk key pair.

Untuk mempelajari lebih lanjut cara membuat akun layanan, menetapkan binding peran ke akun layanan, serta membuat dan menambahkan key pair, lihat Mengelola akun layanan.

Ikuti langkah-langkah berikut untuk menyiapkan akun layanan menggunakan gdcloud CLI:

  1. Membuat akun layanan:

    gdcloud iam service-accounts create SERVICE_ACCOUNT --project=PROJECT_ID

    Ganti kode berikut:

    • SERVICE_ACCOUNT: nama akun layanan. Nama harus unik dalam namespace project.
    • PROJECT_ID: project ID tempat Anda ingin membuat akun layanan. Jika gdcloud init sudah ditetapkan, Anda dapat menghilangkan flag --project.

  2. Buat file JSON Kredensial Default Aplikasi serta pasangan kunci publik dan kunci pribadi:

    gdcloud iam service-accounts keys create APPLICATION_DEFAULT_CREDENTIALS_FILENAME \
    --project=PROJECT_ID \
    --iam-account=SERVICE_ACCOUNT \
    --ca-cert-path=CA_CERTIFICATE_PATH

    Ganti kode berikut:

    • APPLICATION_DEFAULT_CREDENTIALS_FILENAME: nama file JSON, seperti my-service-key.json.
    • PROJECT_ID: project yang akan dibuatkan kunci.
    • SERVICE_ACCOUNT: nama akun layanan yang akan ditambahkan kunci.
    • CA_CERTIFICATE_PATH: flag opsional untuk jalur ke sertifikat certificate authority (CA) yang memverifikasi endpoint autentikasi. Jika Anda tidak menentukan jalur ini, sertifikat CA sistem akan digunakan. Anda harus menginstal CA di sertifikat CA sistem.

    Distributed Cloud menambahkan kunci publik ke kunci akun layanan yang Anda gunakan untuk memverifikasi token web JSON (JWT) yang ditandatangani kunci pribadi. Kunci pribadi ditulis ke file JSON kredensial default aplikasi.

  3. Memberi akun layanan akses ke resource project dengan menetapkan binding peran. Nama peran bergantung pada layanan Vertex AI yang ingin Anda gunakan untuk akun layanan.

    gdcloud iam service-accounts add-iam-policy-binding \
    --project=PROJECT_ID \
    --iam-account=SERVICE_ACCOUNT \
    --role=ROLE

    Ganti kode berikut:

    • PROJECT_ID: project tempat binding peran akan dibuat.
    • SERVICE_ACCOUNT: nama akun layanan yang akan digunakan.

    • ROLE: peran yang telah ditetapkan untuk ditetapkan ke akun layanan. Tentukan peran dalam format Role/name dengan Role adalah jenis Kubernetes, seperti Role atau ProjectRole, dan name adalah nama resource Kubernetes dari peran yang telah ditetapkan. Misalnya, berikut adalah peran yang dapat Anda tetapkan ke akun layanan untuk menggunakan beberapa API terlatih Vertex AI:

      • Untuk menetapkan peran AI OCR Developer (ai-ocr-developer), tetapkan peran ke Role/ai-ocr-developer.
      • Untuk menetapkan peran AI Speech Developer (ai-speech-developer), tetapkan peran ke Role/ai-speech-developer.
      • Untuk menetapkan peran AI Translation Developer (ai-translation-developer), tetapkan peran ke Role/ai-translation-developer.