Mendesain dan men-deploy aplikasi menggunakan Gemini CLI

Gunakan server Model Context Protocol (MCP) Gemini Cloud Assist dan Application Design Center untuk mendesain, men-deploy, dan memecahkan masalah infrastrukturGoogle Cloud langsung di Gemini CLI.

Tujuan

Tutorial ini membantu Anda melakukan hal berikut:

  • Siapkan Gemini CLI untuk menggunakan server MCP Gemini Cloud Assist dan App Design Center.
  • Mendesain dan men-deploy Google Cloud infrastruktur yang dioptimalkan untuk menjalankan kode aplikasi yang ada.
  • Menganalisis dan memecahkan masalah teknis.

Biaya

Dalam dokumen ini, Anda akan menggunakan komponen Google Cloudyang dapat ditagih berikut:

  • App Design Center.
  • Google Cloud resources that you create as part of your application infrastructure.

Untuk membuat perkiraan biaya berdasarkan proyeksi penggunaan Anda, gunakan kalkulator harga.

Pengguna Google Cloud baru mungkin memenuhi syarat untuk mendapatkan uji coba gratis.

Setelah menyelesaikan tugas yang dijelaskan dalam dokumen ini, Anda dapat menghindari penagihan berkelanjutan dengan menghapus resource yang Anda buat. Untuk mengetahui informasi selengkapnya, baca bagian Pembersihan.

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. 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. Instal Google Cloud CLI.

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

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

    gcloud init

  10. 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.

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

  12. Untuk mengakses Gemini Cloud Assist melalui MCP, Anda harus tergabung dalam program Penguji Tepercaya. Hubungi tim akun Anda untuk meminta akses.
  13. Instal Gemini CLI.
  14. Pastikan Anda memiliki peran Admin Pusat Desain Aplikasi (roles/designcenter.admin) di project Anda.
  15. Pastikan Anda memiliki peran yang mencakup izin mcp.googleapis.com/tools.call, seperti salah satu peran Gemini Cloud Assist berikut:
    • Admin Gemini Cloud Assist (roles/geminicloudassist.admin).
    • Editor Gemini Cloud Assist (roles/geminicloudassist.editor).
    • Pengguna Gemini Cloud Assist (roles/geminicloudassist.user).

Menyiapkan lingkungan

Untuk menyiapkan lingkungan, lakukan autentikasi ke Google Cloud dan aktifkan layanan yang diperlukan.

Melakukan autentikasi ke Google Cloud

Lakukan autentikasi ke Google Cloud dengan menjalankan perintah berikut di terminal Anda:

  1. Siapkan Kredensial Default Aplikasi agar server MCP dapat melakukan panggilan API.

     gcloud auth application-default login

Mengaktifkan API

Aktifkan layanan Gemini Cloud Assist dan Application Design Center di project Anda.

  1. Aktifkan layanan Gemini Cloud Assist di project Anda:

     gcloud services enable geminicloudassist.googleapis.com

  2. Aktifkan layanan App Design Center di project Anda:

     gcloud services enable designcenter.googleapis.com

Mengonfigurasi server MCP

Server MCP Gemini Cloud Assist dan App Design Center membantu Anda mendesain, menilai, men-deploy, dan memecahkan masalah infrastruktur Google Cloudmenggunakan perintah bahasa alami. Untuk terhubung ke server MCP, konfigurasi setelan Gemini CLI Anda.

Untuk mengonfigurasi Gemini CLI agar menggunakan server MCP, lakukan hal berikut:

  1. Buka file konfigurasi Gemini CLI Anda di salah satu lokasi berikut:

    • Cakupan pengguna: Untuk menerapkan setelan di semua project Gemini CLI Anda, buka ~/.gemini/settings.json.
    • Cakupan Workspace: Untuk menerapkan setelan untuk project Gemini CLI tertentu, buka .gemini/settings.json.

    Jika file konfigurasi Anda tidak ada, buat file baru.

  2. Di settings.json, tambahkan atau gabungkan blok konfigurasi berikut di bawah kunci mcpServers.

      {
    "mcpServers": {
      "gemini-cloud-assist": {
        "httpUrl": "https://geminicloudassist.googleapis.com/mcp",
        "authProviderType": "google_credentials",
        "oauth": {
          "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
        },
        "timeout": 600000
      },
      "application-design-center": {
        "httpUrl": "https://designcenter.googleapis.com/mcp",
        "authProviderType": "google_credentials",
        "oauth": {
          "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
        },
        "timeout": 600000
      }
    }
  }

    Konfigurasi ini otomatis menggunakan Kredensial Default Aplikasi Anda.

  3. Simpan dan tutup file konfigurasi Anda.

  4. Mulai Gemini CLI.

    gemini

  5. Pastikan server MCP terhubung.

    /mcp list

Menginstal SKILL.md file

File SKILL.md memberikan petunjuk dan alur kerja App Design Center dan server MCP Gemini Cloud Assist untuk desain, deployment, dan pemecahan masalah infrastruktur.

Untuk menambahkan file SKILL.md ke Gemini CLI, lakukan hal berikut.

  1. Buat direktori skills/design-and-deploy di salah satu lokasi berikut:

    • Cakupan pengguna: Untuk menerapkan setelan di semua project Gemini CLI Anda, buat ~/.gemini/skills/design-and-deploy/.
    • Cakupan Workspace: Untuk menerapkan setelan untuk project Gemini CLI tertentu, buat .gemini/skills/design-and-deploy/.

  2. Di direktori skills/design-and-deploy/, buat file SKILL.md menggunakan konten dari designing-and-deploying-infrastructure.

  3. Buat direktori skills/google-gemini-cloud-assist di salah satu lokasi berikut:

    • Cakupan pengguna: Untuk menerapkan setelan di semua project Gemini CLI Anda, buat ~/.gemini/skills/google-gemini-cloud-assist/.
    • Cakupan Workspace: Untuk menerapkan setelan untuk project Gemini CLI tertentu, buat .gemini/skills/google-gemini-cloud-assist/.

  4. Di direktori skills/google-gemini-cloud-assist/, buat file SKILL.md menggunakan konten dari operating-google-cloud.

  5. Keluar dan mulai ulang Gemini CLI.

    /quit

    Saat Anda memulai Gemini CLI lagi, Gemini CLI akan otomatis menemukan file skill Anda.

  6. Pastikan file skill ditemukan secara otomatis.

    /skills list

Anda berhasil mengonfigurasi Gemini CLI untuk terhubung ke server MCP Gemini Cloud Assist dan Pusat Desain Aplikasi serta membuat file keterampilan.

Mendesain Google Cloud infrastruktur

Merancang infrastruktur yang disesuaikan untuk menyimpan dan mengeksekusi kode aplikasi Anda.

  1. Tetapkan project yang ingin Anda gunakan:

    gcloud config set project PROJECT_ID

  2. Minta desain infrastruktur Google Cloud .

     My application code is in REPOSITORY_URL. Design the Google Cloud infrastructure required for my application.

    Agen akan meminta untuk mengaktifkan keterampilan yang Anda konfigurasi. Agen membuat rencana desain infrastruktur dan meminta persetujuan Anda.

  3. Menyetujui rencana.

    Continue with the plan.

    Agen mengidentifikasi alat yang akan digunakan untuk membuat infrastruktur. Agen meminta untuk menggunakan alat setup_adc, yang menyiapkan Pusat Desain Aplikasi di project Anda.

  4. Izinkan Gemini Cloud Assist menggunakan alat yang diusulkan.

    Agen mengusulkan desain dan menanyakan apakah Anda siap men-deploy.

  5. Lakukan iterasi pada desain yang diusulkan.

    The infrastructure looks good, but I want to add a cache for frequently accessed data.

    Agen memperbarui desain untuk mengintegrasikan persyaratan Anda. Agen akan bertanya apakah Anda ingin penjelasan tentang perubahan tersebut, atau apakah Anda ingin menguji perubahan tersebut.

Anda membuat desain infrastruktur awal, dan melakukan iterasi untuk meningkatkan kualitas desain.

Menilai kepatuhan terhadap standar keamanan

Administrator di organisasi Anda kemungkinan telah mengonfigurasi framework keamanan tertentu yang memengaruhi desain dan deployment infrastruktur. Di bagian ini, verifikasi bahwa desain Anda mematuhi standar keamanan yang dikonfigurasi.

  1. Pastikan desain infrastruktur mematuhi standar keamanan organisasi Anda.

    I want to make sure that infrastructure design is compliant with my organization's security standards.

    Agen menganalisis desain infrastruktur berdasarkan framework keamanan yang telah ditentukan oleh administrator organisasi Anda di Security Command Center. Jika audit menemukan masalah kepatuhan, agen akan menyarankan peningkatan keamanan dan meminta persetujuan Anda.

  2. Menerapkan peningkatan keamanan yang direkomendasikan

    Apply the recommended security enhancements.

    Agen akan menerapkan perubahan dan menanyakan apakah Anda siap menyetujui desainnya.

Desain infrastruktur Anda mematuhi framework keamanan organisasi Anda.

Men-deploy desain infrastruktur

Deploy desain infrastruktur ke Google Cloud.

  1. Menyetujui desain dan men-deploy.

    Deploy the infrastructure design to my Google Cloud project.

    Agen men-deploy desain akhir ke project Google Cloud Anda. Agen meminta Anda menyetujui perubahan pada project Anda. Misalnya, Anda mungkin perlu mengaktifkan API.

    Jika aplikasi berhasil di-deploy, agen akan menampilkan detail deployment, komponen arsitektur, dan langkah-langkah untuk menggunakan aplikasi.

  2. Jika deployment Anda gagal, dapatkan bantuan untuk memecahkan masalah. Misalnya, Anda mungkin perlu memperbaiki detail konfigurasi komponen atau izin Identity and Access Management (IAM).

    Fix the component configuration errors.

    Agen memberikan rekomendasi untuk konfigurasi komponen dan membuat tampilan perbedaan untuk Anda tinjau dan setujui.

  3. Untuk mencoba deployment lagi setelah Anda melakukan perubahan, ulangi langkah-langkah di bagian ini.

Anda men-deploy kode aplikasi dan desain infrastruktur ke Google Cloud.

Pembersihan

Agar tidak perlu membayar biaya pada akun Google Cloud Anda untuk resource yang digunakan dalam tutorial ini, hapus project yang berisi resource tersebut, atau simpan project dan hapus setiap resource.

    Menghapus Google Cloud project:

    gcloud projects delete PROJECT_ID

Langkah berikutnya