Mendesain dan men-deploy aplikasi menggunakan Antigravity CLI

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

Tujuan

Tutorial ini membantu Anda melakukan hal berikut:

  • Menyiapkan Antigravity 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 yang dapat ditagih sebagai berikut Google Cloud:

  • 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 keakun Anda. Google Cloud 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

    • Memilih 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 Project Creator (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 Google Cloud project yang Anda buat:

      gcloud config set project PROJECT_ID

      Ganti PROJECT_ID dengan nama Google Cloud project Anda.

  6. Pastikan penagihan diaktifkan untuk Google Cloud project 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

    • Memilih 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 Project Creator (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 Google Cloud project yang Anda buat:

      gcloud config set project PROJECT_ID

      Ganti PROJECT_ID dengan nama Google Cloud project Anda.

  11. Pastikan penagihan diaktifkan untuk Google Cloud project Anda.

  12. Untuk mengakses Gemini Cloud Assist melalui MCP, Anda harus berada dalam program Penguji Tepercaya. Hubungi tim akun Anda untuk meminta akses.
  13. Instal Antigravity CLI
  14. Untuk men-deploy dan menjalankan perintah Antigravity CLI, minta administrator Anda untuk memberi Anda peran yang diperlukan 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 Admin Gemini Cloud Assist (roles/geminicloudassist.admin), atau
    Editor Gemini Cloud Assist (roles/geminicloudassist.editor), atau
    Pengguna Gemini Cloud Assist (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 Google Cloud infrastruktur menggunakan perintah bahasa alami. Untuk terhubung ke server MCP, konfigurasi 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 Anda, buka ~/.gemini/config/mcp_config.json.
    • Cakupan ruang kerja: Untuk menerapkan setelan untuk 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 bagian 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 secara 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 memberikan 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 ruang kerja: 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 ruang kerja: Untuk menerapkan setelan untuk project Antigravity CLI tertentu, buat .agents/skills/google-gemini-cloud-assist/.

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

  5. Keluar dan mulai ulang sesi Antigravity CLI.

    /quit

    Saat Anda memulai Antigravity CLI lagi dengan agy, Antigravity CLI akan otomatis menemukan file keterampilan Anda.

  6. Pastikan file keterampilan 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 keterampilan.

Mendesaininfrastruktur Google Cloud Anda

Desain infrastruktur yang disesuaikan untuk menyimpan dan menjalankan kode aplikasi Anda.

  1. Tetapkan project yang ingin Anda gunakan:

    gcloud config set project PROJECT_ID

  2. Minta desain Google Cloud infrastruktur.

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

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

  3. Setujui rencana tersebut.

    Continue with the plan.

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

  4. Izinkan Gemini Cloud Assist menggunakan alat yang diusulkan.

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

  5. Ulangi 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 bertanya apakah Anda ingin penjelasan tentang perubahan, atau apakah Anda ingin menguji perubahan tersebut.

Anda membuat desain infrastruktur awal, dan mengulanginya 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, pastikan 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. Terapkan peningkatan keamanan yang direkomendasikan

    Apply the recommended security enhancements.

    Agen menerapkan perubahan dan bertanya apakah Anda siap menyetujui desain tersebut.

Desain infrastruktur Anda mematuhi framework keamanan organisasi Anda.

Men-deploy desain infrastruktur

Deploy desain infrastruktur ke Google Cloud.

  1. Setujui desain dan 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 agar Anda dapat meninjau dan menerimanya.

  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.

    Hapus a Google Cloud project:

    gcloud projects delete PROJECT_ID

Langkah berikutnya