Membuat Template Dasar

File konfigurasi dasar mungkin sudah cukup untuk beban kerja sederhana, tetapi untuk arsitektur yang lebih kompleks atau untuk konfigurasi yang ingin Anda gunakan kembali, Anda dapat membagi konfigurasi menjadi template.

Template adalah file terpisah yang diimpor dan digunakan sebagai jenis dalam konfigurasi. Anda dapat menggunakan template sebanyak yang diinginkan dalam konfigurasi.

Template memungkinkan Anda memisahkan konfigurasi menjadi beberapa bagian yang dapat digunakan dan digunakan kembali di berbagai deployment. Template dapat sesederhana atau sespesifik yang Anda butuhkan. Dengan template, Anda juga dapat memanfaatkan fitur seperti properti template, variabel lingkungan, modul, dan fungsi template lainnya untuk membuat file konfigurasi dan template dinamis.

Untuk mengetahui contoh template yang dapat Anda gunakan dalam deployment Anda sendiri, lihat repositori GitHub Deployment Manager.

Sebelum memulai

Sintaksis template

Template dapat ditulis dalam Jinja 2.10.x atau Python 3.x. Jinja dipetakan lebih dekat dengan sintaksis YAML, sehingga mungkin lebih mudah untuk menulis template di Jinja jika Anda lebih memahami YAML.

Anda juga dapat menulis file template di Python dan memanfaatkan Python untuk membuat bagian template secara terprogram. Misalnya, Anda dapat menggunakan library Python untuk memformat definisi template. Jika Anda sudah memahami Python, format ini mungkin lebih cocok untuk Anda.

Deployment Manager menerima template Jinja dan Python. Anda dapat mengimpor template dalam kedua bahasa dalam konfigurasi yang sama.

Membuat template dasar

Template adalah file yang Anda buat, yang ditulis dalam Jinja atau Python. Misalnya, pertimbangkan file konfigurasi berikut:

# Copyright 2016 Google Inc. All rights reserved.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

resources:
- name: vm-created-by-deployment-manager
  type: compute.v1.instance
  properties:
    zone: us-central1-a
    machineType: zones/us-central1-a/machineTypes/n1-standard-1
    disks:
    - deviceName: boot
      type: PERSISTENT
      boot: true
      autoDelete: true
      initializeParams:
        sourceImage: projects/debian-cloud/global/images/family/debian-11
    networkInterfaces:
    - network: global/networks/default

Konfigurasi ini valid, tetapi Anda dapat menyederhanakan konfigurasi lebih lanjut dengan memecah berbagai bagian sebagai file template individual yang dapat Anda gunakan kembali. Untuk membuat template berdasarkan konfigurasi di atas, tarik bagian untuk resource yang dimaksud dan buat file Jinja atau Python baru.

Cuplikan berikut menunjukkan bagian template yang dapat menyederhanakan deployment Anda. Untuk template lengkap, klik Lihat di GitHub.

Jinja 

- name: vm-template
  type: compute.v1.instance
  properties:
    zone: us-central1-a
    machineType: zones/us-central1-a/machineTypes/n1-standard-1
    disks:
    - deviceName: boot
      type: PERSISTENT
      boot: true
      autoDelete: true
      initializeParams:
        sourceImage: projects/debian-cloud/global/images/family/debian-11
    networkInterfaces:
    - network: global/networks/default

Python

Template Python Anda harus memenuhi persyaratan berikut:

  • Template harus menentukan metode yang disebut GenerateConfig(context) atau generate_config(context). Jika Anda menggunakan kedua nama metode dalam template yang sama, metode generate_config() akan diprioritaskan.

    Objek context berisi metadata tentang deployment dan lingkungan Anda, seperti nama deployment, project saat ini, dan sebagainya. Pelajari lebih lanjut cara menggunakan variabel lingkungan khusus deployment.

  • Metode ini harus menampilkan kamus Python.

Selain itu, Anda dapat membuat konten template Anda sendiri.

Contoh

resources.append({
    'name': 'vm-template',
    'type': 'compute.v1.instance',
    'properties': {
        'zone': 'us-central1-a',
        'machineType': 'zones/us-central1-a/machineTypes/n1-standard-1',
        'disks': [{
            'deviceName': 'boot',
            'type': 'PERSISTENT',
            'boot': True,
            'autoDelete': True,
            'initializeParams': {
                'sourceImage':
                    'projects/debian-cloud/global/images/family/debian-11'
            }
        }],
        'networkInterfaces': [{
            'network': 'global/networks/default'
        }]
    }
})

Untuk contoh Python lengkap, lihat repositori GitHub Deployment Manager.

Mengimpor template

Setelah membuat template, impor template tersebut ke dalam file konfigurasi untuk menggunakannya. Untuk mengimpor template, tambahkan bagian imports dalam konfigurasi Anda, diikuti dengan jalur relatif atau absolut dari direktori saat ini. Misalnya, Anda dapat mengimpor template virtual machine dari langkah sebelumnya dengan menambahkan baris berikut ke bagian atas konfigurasi:

imports:
  - path: path/to/my_vm_template.jinja

Jika memiliki jalur file yang panjang, Anda dapat memberikan properti name opsional sebagai alias untuk file. Anda dapat menggunakan nama ini untuk mereferensikan template nanti. Jika Anda tidak memberikan nama, template dapat dirujuk menggunakan path.

imports:
  - path: path/to/my_vm_template.jinja
    name: my_renamed_template.jinja

Anda dapat menggabungkan impor beberapa template, terlepas dari apakah template tersebut adalah Jinja atau Python:

imports:
  - path: path/to/my_vm_template.jinja
    name: my_renamed_template.jinja
  - path: special_vm.py

Jika template Anda menggunakan template lain sebagai dependensi, impor juga template dependen dalam konfigurasi Anda:

imports:
  - path: path/to/my_vm_template.jinja
  - path: special_vm.py
  - path: base_vm.jinja

Anda juga dapat mengimpor file teks untuk menyisipkan konten. Misalnya, jika Anda membuat file bernama resource_type.txt dengan string berikut:

compute.v1.instance

Impor ke konfigurasi Anda dan berikan konten secara inline seperti berikut:

imports:
- path: resource_type.txt

resources:
- name: my-vm
  type: {{ imports["resource_type.txt"] }} # Resolves to "compute.v1.instance"
  properties:
    zone: us-central1-a
    machineType: zones/us-central1-a/machineTypes/f1-micro
    disks:
    - deviceName: boot
      type: PERSISTENT
      boot: true
      autoDelete: true
      initializeParams:
        sourceImage: projects/debian-cloud/global/images/family/debian-9
    networkInterfaces:
    - network: global/networks/default
      accessConfigs:
      - name: External NAT
        type: ONE_TO_ONE_NAT

Men-deploy template

Setelah mengimpor template, gunakan sebagai jenis dalam konfigurasi Anda:

Jinja 

imports:
- path: vm-template.jinja

resources:
- name: my-vm
  type: vm-template.jinja

Python 

imports:
- path: vm-template.py

resources:
- name: my-vm
  type: vm-template.py

Jika Anda tidak memberikan nama untuk template, panggil template menggunakan jalur template:

imports:
- path: path/to/my_vm_template.jinja

resources:
- name: my-first-virtual-machine
  type: path/to/my_vm_template.jinja

Men-deploy template langsung dengan alat command line

Daripada membuat file konfigurasi tingkat teratas, Deployment Manager menawarkan kemampuan untuk men-deploy template langsung di Google Cloud CLI.

Misalnya, permintaan berikut men-deploy template bernama vm-template.jinja:

gcloud deployment-manager deployments create a-single-vm --template vm-template.jinja

Jika template Anda memiliki properti template, Anda juga dapat menetapkan properti ini di command line menggunakan flag --properties:

gcloud deployment-manager deployments create my-igm \
    --template vm-template.jinja \
    --properties zone:us-central1-a

Perlu diperhatikan bahwa:

  • Semua nilai diuraikan sebagai nilai YAML. Misalnya, version: 3 diteruskan sebagai bilangan bulat. Jika Anda ingin menentukannya sebagai string, masukkan tanda kutip tunggal yang di-escape di sekitar nilai, version: \'3\'.

  • Nilai boolean tidak peka huruf besar/kecil, sehingga TRUE, true, dan True diperlakukan sama.

  • Anda harus meneruskan semua properti yang diperlukan yang ditentukan oleh template. Anda tidak dapat hanya memberikan sebagian properti. Jika properti tertentu memiliki nilai default, Anda dapat menghilangkan properti dari command line.

Untuk menentukan beberapa properti, berikan pasangan nilai kunci yang dipisahkan koma. Urutan Anda menentukan pasangan tidak penting. Contoh:

gcloud deployment-manager deployments create my-igm 

    --template vm-template.jinja 

    --properties zone:us-central1-a,machineType:n1-standard-1,image:debian-9

Setelah menjalankan perintah ini, Deployment Manager akan membuat deployment menggunakan template yang Anda berikan. Anda dapat mengonfirmasi bahwa deployment telah dibuat menggunakan Konsol Google Cloud atau gcloud CLI. Untuk mengetahui informasi tentang cara melihat deployment, baca Melihat manifes.

Langkah selanjutnya