Menyiapkan project dan lingkungan pengembangan

Panduan ini menjelaskan cara menyiapkan project Google Cloud untuk mulai menggunakan Vertex AI Vision.

Menyiapkan project

  1. Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

  2. Instal Google Cloud CLI.

  3. Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

  4. Untuk melakukan inisialisasi gcloud CLI, jalankan perintah berikut: 

    gcloud init

  5. Buat atau pilih Google Cloud project.

    Peran yang diperlukan untuk memilih atau membuat project

    • Pilih project: Memilih project tidak memerlukan peran IAM tertentu—Anda dapat memilih project mana pun yang telah diberi peran.
    • Membuat project: Untuk membuat project, Anda memerlukan peran Pembuat Project (roles/resourcemanager.projectCreator), yang berisi izin resourcemanager.projects.create. Pelajari cara memberikan peran.

    • Buat Google Cloud project:

      gcloud projects create PROJECT_ID

      Ganti PROJECT_ID dengan nama untuk Google Cloud project yang Anda buat.

    • Pilih project Google Cloud yang Anda buat:

      gcloud config set project PROJECT_ID

      Ganti PROJECT_ID dengan nama project Google Cloud Anda.

  6. Verifikasi bahwa penagihan diaktifkan untuk project Google Cloud Anda.

  7. Aktifkan Vertex AI Vision API:

    Peran yang diperlukan untuk mengaktifkan API

    Untuk mengaktifkan API, Anda memerlukan peran IAM Service Usage Admin (roles/serviceusage.serviceUsageAdmin), yang berisi izin serviceusage.services.enable. Pelajari cara memberikan peran. 

    gcloud services enable visionai.googleapis.com

  8. Menyiapkan autentikasi:

    1. Pastikan Anda memiliki peran IAM Create Service Accounts (roles/iam.serviceAccountCreator) dan peran IAM Project IAM Admin (roles/resourcemanager.projectIamAdmin). Pelajari cara memberikan peran.

    2. Buat akun layanan: 

      gcloud iam service-accounts create SERVICE_ACCOUNT_NAME

      Ganti SERVICE_ACCOUNT_NAME dengan nama untuk akun layanan.

    3. Memberikan peran IAM roles/visionai.editor ke akun layanan. 

      gcloud projects add-iam-policy-binding PROJECT_ID --member="serviceAccount:SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com" --role=roles/visionai.editor

      Ganti kode berikut:

      • SERVICE_ACCOUNT_NAME: nama dari akun layanan.
      • PROJECT_ID: project ID dimana Anda membuat akun layanan

    4. Membuat file kunci: 

      gcloud iam service-accounts keys create FILE_NAME.json --iam-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com

      Ganti kode berikut:

      • FILE_NAME: nama untuk file kunci
      • SERVICE_ACCOUNT_NAME: nama dari akun layanan.
      • PROJECT_ID: project ID dimana Anda membuat akun layanan

  9. Tetapkan variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS ke jalur file JSON yang berisi kredensial Anda. Variabel ini hanya berlaku untuk sesi shell Anda saat ini. Jadi, jika Anda membuka sesi baru, tetapkan kembali variabel.

  10. Instal Google Cloud CLI.

  11. Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

  12. Untuk melakukan inisialisasi gcloud CLI, jalankan perintah berikut: 

    gcloud init

  13. Buat atau pilih Google Cloud project.

    Peran yang diperlukan untuk memilih atau membuat project

    • Pilih project: Memilih project tidak memerlukan peran IAM tertentu—Anda dapat memilih project mana pun yang telah diberi peran.
    • Membuat project: Untuk membuat project, Anda memerlukan peran Pembuat Project (roles/resourcemanager.projectCreator), yang berisi izin resourcemanager.projects.create. Pelajari cara memberikan peran.

    • Buat Google Cloud project:

      gcloud projects create PROJECT_ID

      Ganti PROJECT_ID dengan nama untuk Google Cloud project yang Anda buat.

    • Pilih project Google Cloud yang Anda buat:

      gcloud config set project PROJECT_ID

      Ganti PROJECT_ID dengan nama project Google Cloud Anda.

  14. Verifikasi bahwa penagihan diaktifkan untuk project Google Cloud Anda.

  15. Aktifkan Vertex AI Vision API:

    Peran yang diperlukan untuk mengaktifkan API

    Untuk mengaktifkan API, Anda memerlukan peran IAM Service Usage Admin (roles/serviceusage.serviceUsageAdmin), yang berisi izin serviceusage.services.enable. Pelajari cara memberikan peran. 

    gcloud services enable visionai.googleapis.com

  16. Menyiapkan autentikasi:

    1. Pastikan Anda memiliki peran IAM Create Service Accounts (roles/iam.serviceAccountCreator) dan peran IAM Project IAM Admin (roles/resourcemanager.projectIamAdmin). Pelajari cara memberikan peran.

    2. Buat akun layanan: 

      gcloud iam service-accounts create SERVICE_ACCOUNT_NAME

      Ganti SERVICE_ACCOUNT_NAME dengan nama untuk akun layanan.

    3. Memberikan peran IAM roles/visionai.editor ke akun layanan. 

      gcloud projects add-iam-policy-binding PROJECT_ID --member="serviceAccount:SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com" --role=roles/visionai.editor

      Ganti kode berikut:

      • SERVICE_ACCOUNT_NAME: nama dari akun layanan.
      • PROJECT_ID: project ID dimana Anda membuat akun layanan

    4. Membuat file kunci: 

      gcloud iam service-accounts keys create FILE_NAME.json --iam-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com

      Ganti kode berikut:

      • FILE_NAME: nama untuk file kunci
      • SERVICE_ACCOUNT_NAME: nama dari akun layanan.
      • PROJECT_ID: project ID dimana Anda membuat akun layanan

  17. Tetapkan variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS ke jalur file JSON yang berisi kredensial Anda. Variabel ini hanya berlaku untuk sesi shell Anda saat ini. Jadi, jika Anda membuka sesi baru, tetapkan kembali variabel.


Tugas tertentu mengharuskan Anda menggunakan produk Google Cloud tambahan selain Vertex AI Vision. Anda mungkin perlu melakukan tugas penyiapan tambahan untuk menggunakan produk Google Cloud lainnya.

Vertex AI Vision SDK

Software Development Kit (SDK) Vertex AI Vision berisi alat dan library untuk Anda mengembangkan program dan alur kerja kustom dengan Vertex AI Vision.

Alat ini merujuk pada serangkaian file sumber biner yang membantu produktivitas Anda saat menggunakan atau mengembangkan solusi menggunakan Vertex AI Vision. Anda juga dapat menambahkan file sumber biner ini ke dalam pembuatan skrip untuk membantu mengelola deployment skala yang lebih besar. Antarmuka command line (CLI) vaictl adalah contoh dalam kategori ini.

Library mengacu pada sekumpulan API pemrograman yang dapat Anda gunakan untuk mengelola, mengontrol, dan melakukan I/O berbagai bentuk secara terprogram dengan Vertex AI Vision. C++ Programming API adalah contoh dalam kategori ini.

Kode untuk alat dan library bersifat open source dan kami menyambut baik developer yang ingin membangunnya secara langsung. Untuk alat, kami juga menawarkan file biner bawaan di platform tertentu yang dapat Anda download untuk digunakan secara langsung. Kami juga menawarkan image Docker untuk kasus ketika platform Anda tidak didukung secara langsung.

Prasyarat

Pertimbangkan prasyarat ini sebelum Anda menggunakan Vertex AI Vision SDK.

Platform yang didukung

Saat ini kami hanya mendukung langsung mesin x86 yang menjalankan distribusi Linux berbasis Debian. Kami juga menawarkan image Docker dengan alat yang sudah dibuat dan diinstal jika Anda menggunakan platform lain.

Persyaratan software tambahan

Sebagian besar dependensi software pihak ketiga yang diperlukan Vertex AI Vision SDK dikelola secara otomatis saat Anda menginstal biner bawaan. Namun, untuk menggunakan aspek tertentu dari fitur dan alur kerja SDK, Anda harus menginstal dependensi tambahan. Bagian ini mencantumkan pengecualian tersebut dan cara mendownload serta menginstalnya.

Python SDK

Paket pip Python menginstal semua dependensinya secara otomatis. Namun, penginstalan Python dasar yang mendasarinya harus memenuhi kondisi berikut:

  • Python >= 3.8.

Membangun dari dependensi sumber

Sebagian besar pengguna dapat menggunakan biner SDK bawaan untuk alur kerja mereka. Jika Anda ingin mengembangkan dan membangun SDK dari sumber, Anda juga harus memastikan sistem Anda memenuhi persyaratan berikut.

  • Instal Bazel. Untuk petunjuk penginstalan, lihat dokumentasi Bazel.

  • Di Ubuntu 20.04, Anda juga memerlukan beberapa dependensi sistem. Anda dapat menginstalnya dengan perintah berikut:

    apt-get install -y --no-install-recommends \
    autoconf \
    automake \
    build-essential \
    ca-certificates \
    flex \
    bison \
    python3 \
    nasm \
    libjpeg-dev

Mendapatkan biner bawaan

Alat vaictl adalah alat biner siap pakai yang dapat digunakan untuk mengontrol Vertex AI Vision, serta mengirim dan menerima data yang diprosesnya.

Bagian ini menunjukkan cara mendownload dan menginstal alat ini.

Instal paket Debian

Anda memiliki dua opsi untuk menggunakan alat command line vaictl, yang Anda perlukan untuk bekerja dengan I/O (data streaming):

  • Instal alat command line secara lokal (OS: Debian GNU/Linux, arsitektur CPU: x86_64) atau
  • Jalankan perintah di image Docker yang telah menginstal semua dependensi.

Gunakan langkah-langkah berikut untuk mendapatkan alat command line vaictl:

Unduh paket

Untuk penginstalan langsung, saat ini kami hanya mendukung distribusi Debian/Ubuntu.

Anda juga dapat mendownload paket Debian ini dari halaman rilis GitHub Vertex AI Vision SDK.

  1. (Opsional) Hapus versi vaictl sebelumnya.

    Sebelum dapat menginstal alat command line vaictl, Anda harus menghapus semua versi alat sebelumnya di komputer Anda:

    sudo apt-get remove visionai
  2. Download paket yang diperlukan. Anda dapat mendownload paket dari halaman rilis GitHub, atau menggunakan perintah berikut: 
    wget https://github.com/google/visionai/releases/download/v0.0.5/visionai_0.0-5_amd64.deb
  3. Setelah mendownload paket, jalankan perintah berikut di direktori tempat Anda mendownload file: 
    sudo apt install ./visionai_0.0-5_amd64.deb
  4. Verifikasi penginstalan: 
    vaictl --help

Mendapatkan Docker

Anda bisa mendapatkan image Docker yang telah menginstal Vertex AI Vision SDK dan semua dependensinya. Image Docker ini tersedia di gcr.io/visionai-public-images/vaictl.

  1. Download image dari Container Registry: 
    docker pull gcr.io/visionai-public-images/vaictl
  2. Jalankan terminal container interaktif. 
    docker run -it --rm gcr.io/visionai-public-images/vaictl /bin/bash
  3. Verifikasi fungsi: 
    vaictl --help

Mendapatkan kode sumber

Vertex AI Vision SDK bersifat open source dan tersedia secara publik di GitHub.

Meskipun SDK bergantung pada definisi API layanan, ketergantungan ini sudah dikelola secara otomatis oleh Bazel dan Anda tidak perlu mendapatkannya secara eksplisit. Namun, jika Anda memerlukan akses langsung ke API layanan, Anda bisa mendapatkannya di repositori GitHub googleapis.

SDK pemrograman Python

Vertex AI Vision juga mendukung Python SDK. Untuk memprogram dengan SDK ini, pastikan Anda telah memenuhi dependensi Python SDK dasar sebelum menginstal Python SDK.

Untuk mengetahui informasi referensi SDK, lihat Referensi Python SDK.

Untuk contoh kode yang menggunakan Python SDK, lihat tutorial Pemburaman wajah dengan Python SDK, atau lihat beberapa contoh dalam distribusi sumber di direktori visionai/python/examples/.

Mendapatkan paket Python SDK

Vertex AI Vision SDK juga berisi library Python. Download dan instal versi Python SDK yang telah dibuat sebelumnya dengan petunjuk berikut.

  1. Download paket.

    Anda dapat mendownload paket Python SDK dari halaman rilis GitHub Vertex AI Vision SDK, atau Anda dapat menjalankan perintah:

    wget https://github.com/google/visionai/releases/download/v0.0.5/visionai-0.0.5-py3-none-any.whl

  2. Opsional. Buat dan aktifkan lingkungan virtual baru:

    python3 -m venv vaivenv
source vaivenv/bin/activate

  3. Instal paket:

    pip3 install visionai-0.0.5-py3-none-any.whl

  4. Opsional. Konfirmasi bahwa penginstalan berhasil:

    python3

    import visionai

  5. Opsional. Nonaktifkan lingkungan virtual Anda:

    deactivate

SDK pemrograman C++

C++ adalah SDK pemrograman pertama yang kami dukung. SDK publik C++ terletak di visionai/public/streams.h. Untuk informasi referensi, lihat dokumentasi referensi.

Langkah berikutnya

Sebelumnya
Panduan memulai: Membangun aplikasi di konsol