Mendownload dan men-deploy Terraform

Application Design Center memungkinkan Anda membuat dan mengekspor kode Terraform untuk template dan aplikasi ke komputer lokal atau repositori GitHub.

Dengan mengekspor kode Terraform, Anda dapat mengelola dan men-deploy aplikasi dengan alat CI/CD Anda sendiri. File Terraform yang diekspor akan otomatis mendaftarkan aplikasi Anda di App Hub untuk mengaktifkan pemantauan runtime di Security Command Center. Aplikasi yang di-deploy secara eksternal diperlakukan sebagai aplikasi yang tidak dikelola. Untuk menggunakan fitur Google Cloud yang berfokus pada aplikasi terkelola seperti penilaian keamanan waktu desain dan melacak temuan keamanan ke sumbernya, deploy aplikasi menggunakan App Design Center.

Sistem akan membuat file Terraform berikut:

  • main.tf: Kode infrastruktur yang menyertakan modul untuk setiap komponen dalam template.
  • outputs.tf: Mengekspos informasi tentang komponen infrastruktur yang di-deploy.
  • variables.tf: Mendeklarasikan nama, jenis, dan deskripsi untuk variabel yang digunakan dalam file main.tf.
  • input.tfvars: Menentukan nilai untuk variabel yang digunakan dalam file main.tf.
  • providers.tf: Menentukan label yang membantu Terraform berinteraksi dengan API dan resource Google Cloud .

Untuk mengetahui informasi latar belakang, lihat Ringkasan Terraform di Google Cloud.

Sebelum memulai

Untuk melakukan tugas dalam dokumen ini, minta administrator untuk memberi Anda peran yang diperlukan di folder khusus aplikasi atau project pengelolaan, seperti yang tercantum dalam tabel berikut:

Tugas Peran yang diperlukan
Mengekspor kode Terraform yang dihasilkan secara lokal atau ke repositori kontrol sumber Admin Aplikasi (roles/designcenter.applicationAdmin), atau
Editor Aplikasi (roles/designcenter.applicationEditor)

Untuk mengetahui informasi selengkapnya tentang peran, lihat Kontrol akses dengan IAM.

Mengekspor kode Terraform

Jika ingin mengelola template dan aplikasi di luar Google Cloud, Anda dapat membuat Terraform dan mengekspornya ke komputer lokal atau ke repositori kode Anda.

Mengekspor secara lokal

Anda dapat mengekspor kode Terraform yang dihasilkan dari template atau dari aplikasi.

Template

  1. Di konsol Google Cloud , buka halaman Templates.

    Buka Template

  2. Klik ID Template yang ingin Anda ekspor.

  3. Klik Dapatkan Kode.

    Sistem akan mendownload file zip ke komputer lokal Anda. Anda dapat men-deploy aplikasi menggunakan alat dan alur kerja deployment Anda sendiri.

Aplikasi

  1. Di Konsol Google Cloud , buka halaman Applications.

    Buka Applications

  2. Klik Nama aplikasi yang ingin Anda ekspor.

  3. Klik Dapatkan Kode.

    Sistem akan mendownload file zip ke komputer lokal Anda. Anda dapat men-deploy aplikasi menggunakan alat dan alur kerja deployment Anda sendiri.

Mengekspor ke repositori Anda

Untuk mengelola template melalui repositori pengelolaan kode sumber, Anda dapat mengekspor template dan aplikasi ke GitHub. Kemudian, Anda dapat menggunakan alur kerja kontrol versi yang ada, serta memicu build, pengujian, dan deployment menggunakan pipeline CI/CD Anda sendiri.

Menghubungkan ke repositori Anda

Untuk membuat koneksi Developer Connect antara repositori GitHub dan project pengelolaan Anda, lakukan hal berikut:

  1. Ubah kebijakan organisasi Anda untuk menambahkan layanan berikut ke daftar yang diizinkan:

    1. developerconnect.googleapis.com.
    2. secretmanager.googleapis.com.

    Untuk mengetahui langkah-langkah mengubah kebijakan organisasi, lihat Menggunakan batasan Batasi Penggunaan Layanan Resource.

  2. Buat koneksi Developer Connect ke repositori GitHub Anda, termasuk hal berikut:

    1. Pilih Aktifkan residensi data.
    2. Tautkan repositori tempat Anda ingin mengekspor aplikasi.

    Untuk mengetahui langkah-langkah membuat koneksi dan menautkan repositori, lihat Menghubungkan GitHub.

  3. Untuk menyalin URI repositori, lakukan hal berikut:

    1. Buka halaman Developer Connect Git repositories.
    2. Di tabel Repositories, klik More Options, lalu pilih Copy resource path.

Membuat dan mengekspor

Untuk membuat kode Terraform dan mengekspor ke repositori GitHub, lakukan hal berikut:

Template

  1. Identifikasi ID ruang Anda.

    gcloud design-center spaces list \
        --project=PROJECT \
        --location=LOCATION
    

    Ganti kode berikut:

  2. Identifikasi ID template untuk template yang ingin Anda ekspor.

    gcloud design-center spaces application-templates list \
        --space=SPACE \
        --project=PROJECT \
        --location=LOCATION
    

    Ganti kode berikut:

  3. Buat kode Terraform template Anda, lalu ekspor ke GitHub.

    gcloud design-center spaces application-templates generate APPLICATION_TEMPLATE \
        --space=SPACE \
        --project=PROJECT \
        --location=LOCATION \
        --developer-connect-export-config-repo-uri=DEVELOPER_CONNECT_EXPORT_CONFIG_REPO_URI \
        --developer-connect-export-config-dir=DEVELOPER_CONNECT_EXPORT_CONFIG_DIR \
        --developer-connect-export-config-branch=DEVELOPER_CONNECT_EXPORT_CONFIG_BRANCH
    

    Ganti kode berikut:

    • APPLICATION_TEMPLATE: ID template dari template yang ingin Anda ekspor.
    • SPACE: ID ruang Anda.
    • PROJECT: ID project pengelolaan Anda.
    • LOCATION: ID lokasi Anda.
    • DEVELOPER_CONNECT_EXPORT_CONFIG_REPO_URI: Jalur resource repositori Developer Connect yang Anda salin di Menghubungkan ke repositori Anda, seperti projects/my-project/locations/us-central1/connections/my-connection/gitRepositoryLinks/my-repo. Link repositori harus berada di lokasi yang sama (LOCATION) dengan ruang Anda.
    • DEVELOPER_CONNECT_EXPORT_CONFIG_DIR: Jalur direktori yang relatif terhadap root repositori GitHub Anda, seperti terraform/my-template (atau / untuk direktori root).
    • DEVELOPER_CONNECT_EXPORT_CONFIG_BRANCH: Cabang di repositori GitHub Anda.

    Untuk informasi selengkapnya, lihat perintah gcloud design-center spaces application-templates generate.

  4. Lihat repositori Anda untuk memverifikasi bahwa template telah berhasil diekspor.

Aplikasi

  1. Identifikasi ID ruang Anda.

    gcloud design-center spaces list \
        --project=PROJECT \
        --location=LOCATION
    

    Ganti kode berikut:

  2. Identifikasi ID aplikasi untuk aplikasi yang ingin Anda ekspor.

    gcloud design-center spaces applications list \
        --space=SPACE \
        --project=PROJECT \
        --location=LOCATION
    

    Ganti kode berikut:

  3. Buat kode Terraform aplikasi Anda, lalu ekspor ke GitHub.

    gcloud design-center spaces applications generate APPLICATION \
        --space=SPACE \
        --project=PROJECT \
        --location=LOCATION \
        --developer-connect-export-config-repo-uri=DEVELOPER_CONNECT_EXPORT_CONFIG_REPO_URI \
        --developer-connect-export-config-dir=DEVELOPER_CONNECT_EXPORT_CONFIG_DIR \
        --developer-connect-export-config-branch=DEVELOPER_CONNECT_EXPORT_CONFIG_BRANCH
    

    Ganti kode berikut:

    • APPLICATION: ID aplikasi dari aplikasi yang ingin Anda ekspor.
    • SPACE: ID ruang Anda.
    • PROJECT: ID project pengelolaan Anda.
    • LOCATION: ID lokasi Anda.
    • DEVELOPER_CONNECT_EXPORT_CONFIG_REPO_URI: Jalur resource repositori Developer Connect yang Anda salin di Menghubungkan ke repositori Anda, seperti projects/my-project/locations/us-central1/connections/my-connection/gitRepositoryLinks/my-repo. Link repositori harus berada di lokasi yang sama (LOCATION) dengan ruang Anda.
    • DEVELOPER_CONNECT_EXPORT_CONFIG_DIR: Jalur direktori yang relatif terhadap root repositori GitHub Anda, seperti terraform/my-app (atau / untuk direktori root).
    • DEVELOPER_CONNECT_EXPORT_CONFIG_BRANCH: Cabang di repositori GitHub Anda.

    Untuk informasi selengkapnya, lihat perintah gcloud design-center spaces applications generate.

  4. Lihat repositori Anda untuk memastikan bahwa aplikasi berhasil diekspor.

Langkah berikutnya