Model dan paket unit deployment

Halaman ini menjelaskan cara memodelkan dan mengemas unit deployment untuk penawaran SaaS. Di SaaS Runtime, unit deployment disebut jenis unit.

Buat satu jenis unit untuk setiap komponen penawaran SaaS yang ingin Anda kelola secara terpisah. Untuk mengetahui detail selengkapnya, lihat bagian berikut Menentukan model penawaran SaaS.

Jika diinginkan, Anda dapat membuat penawaran SaaS menggunakan satu jenis unit untuk seluruh penawaran SaaS.

Jenis unit ditentukan oleh blueprint, yang merupakan konfigurasi Terraform yang dikemas sebagai image OCI. Sebelum membuat jenis unit, Anda harus membuat cetak biru untuk setiap jenis unit. Untuk mengetahui detail tentang cara membuat cetak biru, lihat Membuat dan mengupload cetak biru.

Sebelum memulai

  1. Pastikan Anda telah menentukan penawaran SaaS untuk aplikasi SaaS Anda.
  2. Pastikan Anda telah membuat repositori Artifact Registry.
  3. Pastikan Anda memiliki akun layanan dengan izin yang diperlukan. Untuk mengetahui detailnya, lihat Akun layanan SaaS Runtime.
  4. Untuk setiap jenis unit yang Anda buat, pastikan Anda memiliki konfigurasi Terraform dan telah menyiapkan cetak birunya. Untuk mengetahui detailnya, lihat bagian berikut Menentukan model penawaran SaaS.

Menentukan model penawaran SaaS

Untuk memodelkan penawaran SaaS, Anda perlu menentukan jumlah jenis unit yang akan dibuat, dan hubungan antara jenis unit ini.

Misalnya, Anda dapat membuat dua jenis unit: satu jenis unit untuk infrastruktur seperti VM, dan satu jenis unit untuk aplikasi yang di-deploy ke infrastruktur. Jika diinginkan, Anda dapat membuat penawaran SaaS menggunakan satu jenis unit untuk seluruh penawaran SaaS.

Untuk memutuskan cara memodelkan penawaran SaaS menggunakan jenis unit, pertimbangkan hal berikut:

  • Tinjau dependensi antarkomponen penawaran SaaS. Misalnya, jika penawaran SaaS mencakup aplikasi yang di-deploy ke cluster Kubernetes bersama, pertimbangkan untuk menggunakan jenis unit guna memodelkan cluster bersama ini.
  • Pertimbangkan siklus rilis dan pemeliharaan komponen penawaran SaaS. Jika ada komponen yang dikelola bersama, seperti infrastruktur, pertimbangkan untuk memodelkan komponen ini dengan satu jenis unit.

Setelah menentukan model ini, Anda perlu membuat cetak biru untuk setiap jenis unit. Untuk melakukannya, Anda harus:

  1. Identifikasi konfigurasi Terraform untuk terhubung ke jenis unit ini. Untuk mengetahui detail selengkapnya tentang konfigurasi Terraform yang diperlukan, lihat Blueprint di SaaS Runtime.
  2. Pastikan konfigurasi Terraform dikemas sebagai image OCI dan dikirim ke Artifact Registry, atau berada dalam arsip zip atau repositori Git. Untuk mengetahui detail selengkapnya, lihat Membuat dan mengupload blueprint.

Setelah memiliki cetak biru untuk setiap jenis unit, Anda dapat mengikuti petunjuk di halaman ini untuk membuat jenis unit.

Membuat jenis unit

Anda dapat membuat jenis unit menggunakan konfigurasi Terraform yang disediakan dengan cara berikut:

  • Dalam arsip zip.
  • Di repositori Git.
  • Dikemas sebagai image OCI.

Membuat jenis unit menggunakan arsip ZIP

Untuk membuat jenis unit menggunakan konfigurasi Terraform yang ada dalam arsip zip, selesaikan petunjuk berikut.

Untuk mengetahui detail tentang cara menyiapkan arsip ZIP, lihat Mengupload arsip ZIP.

Untuk membuat jenis unit:

  1. Di konsol, buka SaaS Runtime > Unit Kinds.

    Buka Jenis unit

  2. Pilih Create.

  3. Untuk Buat cetak biru, pilih Upload untuk mengupload arsip zip yang berisi konfigurasi Terraform.

    1. Klik Browse dan temukan arsip zip dengan konfigurasi Terraform yang menentukan resource atau aplikasi yang merupakan bagian dari jenis unit ini.

    2. Klik Berikutnya: Konfigurasi blueprint.

  4. Di halaman Blueprint toko:

    1. Untuk Select repository from Artifact Registry, klik Browse, lalu pilih repositori yang Anda buat.

    2. Untuk Nama image artefak, masukkan nama untuk image OCI.

    3. Untuk versi Terraform Infrastructure Manager, pilih versi Terraform yang akan digunakan untuk deployment. Untuk daftar versi Terraform yang didukung, lihat Versi Terraform yang didukung.

    4. Untuk akun layanan Cloud Build, pilih akun layanan yang memiliki izin untuk membuat image. Untuk mengetahui detailnya, lihat Akun layanan pembuatan artefak.

    5. Klik Berikutnya: Detail jenis unit.

  5. Di halaman Configure unit kind properties, lakukan tindakan berikut:

    1. Untuk Unit kind name, masukkan nama untuk jenis unit. Nama hanya boleh berisi huruf kecil, angka, atau tanda hubung.

    2. Untuk SaaS Offering, pilih penawaran SaaS yang ingin Anda kaitkan dengan jenis unit ini.

    3. Untuk Dependensi:

      • Jika ini adalah jenis unit pertama atau satu-satunya yang Anda buat untuk penawaran SaaS, jangan tambahkan dependensi.

      • Jika Anda telah membuat jenis unit lain yang bergantung pada jenis unit ini, pilih Tambahkan dependensi.

        1. Untuk Jenis unit, pilih jenis unit yang ada yang bergantung pada jenis unit yang Anda buat.

        2. Untuk Alias, ketik nama yang dapat Anda gunakan untuk pemetaan variabel input.

        3. Klik Done.

        4. Jika Anda ingin menentukan pemetaan variabel, lakukan langkah-langkah berikut. Untuk mengetahui detail tentang pemetaan variabel, lihat Pemetaan variabel.

          1. Pilih Tentukan pemetaan variabel input dan output.

          2. Untuk Pemetaan variabel input:

            1. Pilih Tambahkan pemetaan variabel input.
            2. Untuk Variable, ketik nama variabel input.
            3. Untuk Jenis pemetaan, pilih:
              • Dari untuk memetakan dari jenis unit lainnya.
              • To untuk dipetakan ke jenis unit lainnya.
            4. Untuk Dependency, Pilih jenis unit yang ada yang akan Anda petakan variabelnya.
            5. Untuk Output variable, ketik nama variabel output.
            6. Pilih Selesai.

          3. Untuk menambahkan variabel input lain, pilih Tambahkan pemetaan variabel input dan ulangi langkah-langkahnya.

          4. Untuk menambahkan pemetaan variabel output:

            1. Pilih tab Pemetaan variabel output.
            2. Pilih Tambahkan pemetaan variabel output, lalu ulangi langkah-langkah yang Anda ikuti untuk pemetaan variabel input.

  6. Klik Berikutnya: Konfigurasi rilis

  7. Untuk Nama rilis, ketik nama untuk rilis.

  8. Opsional: Tambahkan label ke resource yang Anda deploy. Untuk mengetahui detail selengkapnya tentang label, lihat Ringkasan label.

    Untuk menambahkan label:

    1. Di bagian Label, pilih Tambahkan label.

    2. Untuk Kunci 1 dan Nilai 1, masukkan pasangan nilai kunci yang diinginkan.

    3. Ulangi langkah-langkah tersebut untuk setiap label yang ingin Anda tambahkan.

  9. Klik Create.

Anda kini telah membuat jenis unit. Untuk membuat jenis unit lain, ulangi langkah yang sama dan gunakan arsip ZIP yang berisi konfigurasi Terraform untuk jenis unit berikutnya ini.

Jika Anda telah membuat semua jenis unit yang diperlukan untuk penawaran SaaS, Anda dapat men-deploy instance unit.

Membuat jenis unit menggunakan repositori Git

Untuk membuat jenis unit menggunakan konfigurasi Terraform yang ada di repositori Git, selesaikan petunjuk berikut.

Untuk mengetahui detail tentang cara menggunakan repositori Git untuk file Terraform, lihat artikel Menghubungkan ke repositori Git.

  1. Di konsol, buka SaaS Runtime > Unit Kinds.

    Buka Jenis unit

  2. Pilih Create.

  3. Untuk Create blueprint, pilih Link external repository.

  4. Untuk Repositori, pilih repositori Git yang memiliki konfigurasi Terraform:

    1. Jika repositori Git ditautkan, pilih repositori dari daftar.

    2. Jika repositori tidak ditautkan, klik Tautkan repositori baru untuk menggunakan Developer Connect guna menautkan repositori.

      1. Pilih Buat koneksi baru.

      2. Untuk Region, pilih region untuk koneksi Developer Connect. Sebaiknya gunakan region yang sama dengan region yang digunakan untuk repositori Artifact Registry.

      3. Opsional: Untuk Kunci KMS, Anda dapat menentukan kunci KMS untuk enkripsi.

      4. Untuk Branch, tentukan cabang Git yang memiliki konfigurasi Terraform yang ingin Anda kaitkan dengan jenis unit ini.

  5. Di halaman Blueprint toko:

    1. Untuk Select repository from Artifact Registry, klik Browse dan pilih repositori Artifact Registry yang Anda gunakan untuk penawaran SaaS.

    2. Untuk Nama image artefak, masukkan nama untuk image OCI.

    3. Untuk versi Terraform Infrastructure Manager, pilih versi Terraform yang akan digunakan untuk deployment. Untuk daftar versi Terraform yang didukung, lihat Versi Terraform yang didukung.

    4. Untuk akun layanan Cloud Build, pilih akun layanan yang memiliki izin untuk membuat image. Untuk mengetahui detailnya, lihat Akun layanan pembuatan artefak.

    5. Klik Berikutnya: Detail jenis unit.

  6. Di halaman Configure unit kind properties, lakukan tindakan berikut:

    1. Untuk Unit kind name, masukkan nama untuk jenis unit. Nama hanya boleh berisi huruf kecil, angka, atau tanda hubung.

    2. Untuk SaaS Offering, pilih penawaran SaaS yang ingin Anda kaitkan dengan jenis unit ini.

    3. Untuk Dependensi:

      • Jika ini adalah jenis unit pertama atau satu-satunya yang Anda buat untuk penawaran SaaS, jangan tambahkan dependensi.

      • Jika Anda telah membuat jenis unit lain yang bergantung pada jenis unit ini, pilih Tambahkan dependensi.

        1. Untuk Jenis unit, pilih jenis unit yang ada yang bergantung pada jenis unit yang Anda buat.

        2. Untuk Alias, ketik nama yang dapat Anda gunakan untuk pemetaan variabel input.

        3. Klik Done.

        4. Jika Anda ingin menentukan pemetaan variabel, lakukan langkah-langkah berikut. Untuk mengetahui detail tentang pemetaan variabel, lihat Pemetaan variabel.

          1. Pilih Tentukan pemetaan variabel input dan output.

          2. Untuk Pemetaan variabel input:

            1. Pilih Tambahkan pemetaan variabel input.
            2. Untuk Variable, ketik nama variabel input.
            3. Untuk Jenis pemetaan, pilih:
              • Dari untuk memetakan dari jenis unit lainnya.
              • To untuk dipetakan ke jenis unit lainnya.
            4. Untuk Dependency, Pilih jenis unit yang ada yang akan Anda petakan variabelnya.
            5. Untuk Output variable, ketik nama variabel output.
            6. Pilih Selesai.

          3. Untuk menambahkan variabel input lain, pilih Tambahkan pemetaan variabel input dan ulangi langkah-langkahnya.

          4. Untuk menambahkan pemetaan variabel output:

            1. Pilih tab Pemetaan variabel output.
            2. Pilih Tambahkan pemetaan variabel output, lalu ulangi langkah-langkah yang Anda ikuti untuk pemetaan variabel input.

  7. Klik Berikutnya: Konfigurasi rilis

  8. Untuk Nama rilis, ketik nama untuk rilis.

  9. Opsional: Tambahkan label ke resource yang Anda deploy. Untuk mengetahui detail selengkapnya tentang label, lihat Ringkasan label.

    Untuk menambahkan label:

    1. Di bagian Label, pilih Tambahkan label.

    2. Untuk Kunci 1 dan Nilai 1, masukkan pasangan nilai kunci yang diinginkan.

    3. Ulangi langkah-langkah tersebut untuk setiap label yang ingin Anda tambahkan.

  10. Klik Create.

Anda kini telah membuat jenis unit. Untuk membuat jenis unit lain, ulangi langkah yang sama dan gunakan repositori Git yang berisi konfigurasi Terraform untuk jenis unit berikutnya ini.

Jika Anda telah membuat semua jenis unit yang diperlukan untuk penawaran SaaS, Anda dapat men-deploy instance unit.

Membuat jenis unit menggunakan gambar yang ada

Untuk membuat jenis unit menggunakan blueprint yang ada, yaitu image OCI, selesaikan petunjuk berikut.

Untuk mengetahui detail tentang cara membuat image OCI, lihat:

  1. Di konsol, buka SaaS Runtime > Unit Kinds.

    Buka Jenis unit

  2. Pilih Create.

  3. Untuk Create blueprint, pilih Select an existing image from artifact registry.

  4. Klik Berikutnya: Konfigurasi blueprint

  5. Di halaman Blueprint toko:

    1. Untuk Select or enter an existing blueprint from Artifact Registry:

      1. Klik Browse.

      2. Buka image yang berisi konfigurasi Terraform.

      3. Klik Pilih.

    2. Klik Berikutnya: Detail jenis unit.

  6. Di halaman Configure unit kind properties, lakukan tindakan berikut:

    1. Untuk Unit kind name, masukkan nama untuk jenis unit. Nama hanya boleh berisi huruf kecil, angka, atau tanda hubung.

    2. Untuk SaaS Offering, pilih penawaran SaaS yang ingin Anda kaitkan dengan jenis unit ini.

    3. Untuk Dependensi:

      • Jika ini adalah jenis unit pertama atau satu-satunya yang Anda buat untuk penawaran SaaS, jangan tambahkan dependensi.

      • Jika Anda telah membuat jenis unit lain yang bergantung pada jenis unit ini, pilih Tambahkan dependensi.

        1. Untuk Jenis unit, pilih jenis unit yang ada yang bergantung pada jenis unit yang Anda buat.

        2. Untuk Alias, ketik nama yang dapat Anda gunakan untuk pemetaan variabel input.

        3. Klik Done.

        4. Jika Anda ingin menentukan pemetaan variabel, lakukan langkah-langkah berikut. Untuk mengetahui detail tentang pemetaan variabel, lihat Pemetaan variabel.

          1. Pilih Tentukan pemetaan variabel input dan output.

          2. Untuk Pemetaan variabel input:

            1. Pilih Tambahkan pemetaan variabel input.
            2. Untuk Variable, ketik nama variabel input.
            3. Untuk Jenis pemetaan, pilih:
              • Dari untuk memetakan dari jenis unit lainnya.
              • To untuk dipetakan ke jenis unit lainnya.
            4. Untuk Dependency, Pilih jenis unit yang ada yang akan Anda petakan variabelnya.
            5. Untuk Output variable, ketik nama variabel output.
            6. Pilih Selesai.

          3. Untuk menambahkan variabel input lain, pilih Tambahkan pemetaan variabel input dan ulangi langkah-langkahnya.

          4. Untuk menambahkan pemetaan variabel output:

            1. Pilih tab Pemetaan variabel output.
            2. Pilih Tambahkan pemetaan variabel output, lalu ulangi langkah-langkah yang Anda ikuti untuk pemetaan variabel input.

  7. Klik Berikutnya: Konfigurasi rilis

  8. Untuk Nama rilis, ketik nama untuk rilis.

  9. Opsional: Tambahkan label ke resource yang Anda deploy. Untuk mengetahui detail selengkapnya tentang label, lihat Ringkasan label.

    Untuk menambahkan label:

    1. Di bagian Label, pilih Tambahkan label.

    2. Untuk Kunci 1 dan Nilai 1, masukkan pasangan nilai kunci yang diinginkan.

    3. Ulangi langkah-langkah tersebut untuk setiap label yang ingin Anda tambahkan.

  10. Klik Create.

Anda kini telah membuat jenis unit. Untuk membuat jenis unit lain, ulangi langkah-langkah yang sama dan gunakan image OCI yang berisi konfigurasi Terraform untuk jenis unit berikutnya ini.

Jika Anda telah membuat semua jenis unit yang diperlukan untuk penawaran SaaS, Anda dapat men-deploy instance unit.

Langkah berikutnya