Mendesain dan men-deploy aplikasi menggunakan Antigravity CLI

Server Model Context Protocol (MCP) Gemini Cloud Assist dan Application Design Center memungkinkan Anda mendesain, men-deploy, dan memecahkan masalah infrastrukturGoogle Cloud langsung di Antigravity CLI. Setelah menghubungkan server MCP dan menginstal file kemampuan agen, Anda dapat membuat infrastruktur untuk kode aplikasi Anda. Anda juga dapat menilai kepatuhan terhadap standar keamanan dan menyelesaikan masalah deployment menggunakan perintah bahasa alami.

Tujuan

Tutorial ini membantu Anda melakukan hal berikut:

  • Siapkan Antigravity CLI untuk menggunakan server MCP Gemini Cloud Assist dan App Design Center.
  • Mendesain dan men-deploy infrastruktur Google Cloud 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. Instal Google Cloud CLI.

  2. Konfigurasi gcloud CLI agar menggunakan identitas gabungan Anda.

    Untuk mengetahui informasi selengkapnya, lihat Login ke gcloud CLI dengan identitas gabungan Anda.

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

    gcloud init

  4. Buat atau pilih project Google Cloud .

    Peran yang diperlukan untuk memilih atau membuat project

    • Memilih project: Memilih project tidak memerlukan peran IAM tertentu—Anda dapat memilih project apa pun yang perannya telah diberikan kepada Anda.
    • Membuat project: Untuk membuat project, Anda memerlukan peran Project Creator (roles/resourcemanager.projectCreator), yang berisi izin resourcemanager.projects.create. Pelajari cara memberikan peran.

    • Buat project Google Cloud :

      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.

  5. Pastikan penagihan diaktifkan untuk project Google Cloud Anda.

  6. Untuk mengakses Gemini Cloud Assist melalui MCP, Anda harus tergabung dalam program Penguji Tepercaya. Hubungi tim akun Anda untuk meminta akses.
  7. Menginstal Antigravity CLI
  8. Untuk men-deploy dan menjalankan perintah Antigravity CLI, minta administrator untuk memberi Anda peran yang diperlukan di dalam batas project Anda, seperti yang tercantum dalam tabel berikut:
    Tugas Peran yang diperlukan
    Menyiapkan App Design Center di project Anda Admin Application Design Center (roles/designcenter.admin)
    Mengakses dan memanggil Gemini Cloud Assist melalui MCP Gemini Cloud Assist Admin (roles/geminicloudassist.admin), atau
    Gemini Cloud Assist Editor (roles/geminicloudassist.editor), atau
    Gemini Cloud Assist User (roles/geminicloudassist.user)

Menyiapkan lingkungan

Untuk menyiapkan lingkungan Anda, 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 Cloud menggunakan perintah bahasa alami. Untuk terhubung ke server MCP, konfigurasikan setelan Antigravity Anda.

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

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

    • Cakupan pengguna: Untuk menerapkan setelan di semua project Antigravity CLI, buka ~/.gemini/config/mcp_config.json.
    • Cakupan Workspace: Untuk menerapkan setelan pada project Antigravity CLI tertentu, buka .agents/mcp_config.json.

    Jika file konfigurasi Anda tidak ada, buat file baru.

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

      {
    "mcpServers": {
      "gemini-cloud-assist": {
        "serverUrl": "https://geminicloudassist.googleapis.com/mcp",
        "authProviderType": "google_credentials"
      },
      "application-design-center": {
        "serverUrl": "https://designcenter.googleapis.com/mcp",
        "authProviderType": "google_credentials"
      }
    }
  }

    Konfigurasi ini otomatis menggunakan Kredensial Default Aplikasi Anda.

  3. Simpan dan tutup file konfigurasi Anda.

  4. Mulai Antigravity CLI.

    agy

  5. Pastikan server MCP terhubung.

    /mcp list

Menginstal file SKILL.md

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

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

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

    • Cakupan pengguna: Untuk menerapkan setelan di semua project Antigravity CLI Anda, buat ~/.gemini/config/skills/design-and-deploy/.
    • Cakupan Workspace: Untuk menerapkan setelan untuk project Antigravity CLI tertentu, buat .agents/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 Antigravity CLI Anda, buat ~/.gemini/config/skills/google-gemini-cloud-assist/.
    • Cakupan Workspace: Untuk menerapkan setelan untuk project Antigravity CLI tertentu, buat .agents/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 sesi Antigravity CLI.

    /quit

    Saat Anda memulai Antigravity CLI lagi dengan agy, alat ini akan otomatis menemukan file kemampuan Anda.

  6. Pastikan file skill ditemukan secara otomatis.

    /skills list

Anda berhasil mengonfigurasi Antigravity CLI untuk terhubung ke server MCP App Design Center dan Gemini Cloud Assist serta membuat file skill.

Mendesain infrastruktur Google Cloud Anda

Mendesain 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 akan membuat rencana desain infrastruktur dan meminta persetujuan Anda.

  3. Setujui rencana.

    Continue with the plan.

    Agen mengidentifikasi alat yang akan digunakan untuk membuat infrastruktur. Agen meminta untuk menggunakan alat setup_adc, yang menyiapkan App Design Center di project Anda.

  4. Izinkan Gemini Cloud Assist menggunakan alat yang diusulkan.

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

  5. Melakukan iterasi pada desain yang diusulkan.

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

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

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

Menilai kepatuhan terhadap standar keamanan

Administrator di organisasi Anda kemungkinan telah mengonfigurasi framework keamanan tertentu yang menginformasikan 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 desain tersebut.

Desain infrastruktur Anda mematuhi framework keamanan organisasi Anda.

Men-deploy desain infrastruktur

Men-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 akan meminta Anda untuk 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 diff untuk Anda tinjau dan terima.

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

Anda telah 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 project Google Cloud :

    gcloud projects delete PROJECT_ID

Langkah berikutnya