Langkah 1: Siapkan project dan repositori sumber

Pada langkah ini, Anda akan menyiapkan project Google Cloud dan lingkungan Python di Cloud Shell, mengaktifkan API yang diperlukan, dan menetapkan Identity and Access Management (IAM) yang diperlukan untuk menyelesaikan tutorial. Anda juga menyiapkan repositori GitHub yang berisi file sumber aplikasi dengan melakukan fork dan meng-clone GoogleCloudPlatform/generative-ai repositori resource. Setelah menyelesaikan langkah-langkah ini, Anda memverifikasi konfigurasi dengan menjalankan dan menguji aplikasi secara lokal di Cloud Shell.

Sebelum memulai

  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. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

    Buka pemilih project

  3. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

  4. Aktifkan API Vertex AI, Compute Engine, Artifact Registry, Identity-Aware Proxy (IAP), Cloud Run Admin, Cloud Build, Identity and Access Management (IAM) API, and Gemini for Google Cloud.

    Mengaktifkan API

  5. Pastikan Anda memiliki peran berikut di project: Vertex AI User, Cloud Build Editor, Cloud Run Admin, Artifact Registry Admin, Compute Load Balancer Admin, Service Account User, IAP Policy Admin, OAuth Config Editor, and Service Usage Admin.

    Memeriksa peran

    1. Di konsol Google Cloud, buka halaman IAM.

      Buka IAM
    2. Pilih project.
    3. Di kolom Akun utama, cari baris yang berisi alamat email Anda.

      Jika alamat email Anda tidak ada di kolom tersebut, berarti Anda tidak memiliki peran apa pun.

    4. Di kolom Peran untuk baris yang berisi alamat email Anda, periksa apakah daftar peran menyertakan peran yang diperlukan.

    Memberikan peran

    1. Di konsol Google Cloud, buka halaman IAM.

      Buka IAM
    2. Pilih project.
    3. Klik Berikan akses.
    4. Di kolom Akun utama baru, masukkan alamat email Anda.
    5. Di daftar Pilih peran, pilih peran.
    6. Untuk memberikan peran tambahan, klik Tambahkan peran lain, lalu tambahkan setiap peran tambahan.
    7. Klik Simpan.
  6. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

    Buka pemilih project

  7. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

  8. Aktifkan API Vertex AI, Compute Engine, Artifact Registry, Identity-Aware Proxy (IAP), Cloud Run Admin, Cloud Build, Identity and Access Management (IAM) API, and Gemini for Google Cloud.

    Mengaktifkan API

  9. Pastikan Anda memiliki peran berikut di project: Vertex AI User, Cloud Build Editor, Cloud Run Admin, Artifact Registry Admin, Compute Load Balancer Admin, Service Account User, IAP Policy Admin, OAuth Config Editor, and Service Usage Admin.

    Memeriksa peran

    1. Di konsol Google Cloud, buka halaman IAM.

      Buka IAM
    2. Pilih project.
    3. Di kolom Akun utama, cari baris yang berisi alamat email Anda.

      Jika alamat email Anda tidak ada di kolom tersebut, berarti Anda tidak memiliki peran apa pun.

    4. Di kolom Peran untuk baris yang berisi alamat email Anda, periksa apakah daftar peran menyertakan peran yang diperlukan.

    Memberikan peran

    1. Di konsol Google Cloud, buka halaman IAM.

      Buka IAM
    2. Pilih project.
    3. Klik Berikan akses.
    4. Di kolom Akun utama baru, masukkan alamat email Anda.
    5. Di daftar Pilih peran, pilih peran.
    6. Untuk memberikan peran tambahan, klik Tambahkan peran lain, lalu tambahkan setiap peran tambahan.
    7. Klik Simpan.

Menyiapkan repositori sumber

  1. Di GitHub, lakukan fork repositori GoogleCloudPlatform/generative-ai. Pelajari lebih lanjut repositori forking di GitHub.

    Melakukan fork repositori di GitHub

  1. Di konsol Google Cloud, aktifkan Cloud Shell.

    Aktifkan Cloud Shell

    Di bagian bawah Google Cloud Console, Cloud Shell sesi akan terbuka dan menampilkan perintah command line. Cloud Shell adalah lingkungan shell dengan Google Cloud CLI yang sudah terinstal, dan dengan nilai yang sudah ditetapkan untuk project Anda saat ini. Diperlukan waktu beberapa detik untuk melakukan inisialisasi sesi.

  2. Di terminal Cloud Shell, jalankan perintah berikut untuk meng-clone repositori forked dan setel gemini-streamlit-cloudrun seperti Active Directory:
    cd
    git clone https://github.com/GIT_USER_NAME/FORK_NAME/
    cd FORK_NAME/gemini/sample-apps/gemini-streamlit-cloudrun

    Ganti kode berikut:

    • GIT_USER_NAME: Nama pengguna GitHub Anda.
    • FORK_NAME: Nama repositori fork yang baru saja Anda buat di GitHub.

Menyiapkan lingkungan dan dependensi

  1. Di terminal Cloud Shell, jalankan perintah berikut untuk menyiapkan lingkungan virtual:

    python3 -m venv gemini-streamlit
    source gemini-streamlit/bin/activate
    pip install -r requirements.txt
    
  2. Jalankan perintah berikut untuk menetapkan variabel lingkungan yang diperlukan untuk inisialisasi Vertex AI:

    export GCP_PROJECT=$GOOGLE_CLOUD_PROJECT
    export GCP_REGION='us-central1' 
    

Menguji aplikasi secara lokal

  1. Dari terminal Cloud Shell, jalankan aplikasi dengan menjalankan perintah berikut:

    streamlit run app.py \
      --browser.serverAddress=localhost \
      --server.enableCORS=false \
      --server.enableXsrfProtection=false \
      --server.port 8080
    
  2. Untuk melihat pratinjau aplikasi, di taskbar Cloud Shell, klik Tombol Web Preview, lalu klik Preview on port 8080.

    Untuk mengetahui informasi selengkapnya tentang penggunaan fitur Pratinjau Web, lihat Melihat pratinjau aplikasi web.