Menggunakan referensi

Saat menentukan properti untuk konfigurasi atau template, Anda dapat menggunakan referensi ke properti resource lain, bukan memberikan nilai secara langsung. Misalnya, jika Anda ingin membuat pengelola grup instance yang menggunakan template instance dari deployment yang sama, alih-alih mengetik link lengkap untuk template instance secara eksplisit, Anda dapat menggunakan referensi dengan sintaksis $(ref.instance-template.selfLink).

Dengan referensi, Anda dapat:

• Mengakses properti yang tidak ditentukan hingga resource dibuat. Misalnya, saat menentukan mesin virtual dalam konfigurasi, Anda belum mengetahui alamat IP-nya. Namun, Anda tetap dapat menggunakan referensi ke alamat IP. Saat Anda men-deploy konfigurasi, VM akan dibuat terlebih dahulu, dan Deployment Manager akan mendapatkan alamat IP eksternal saat tersedia.

• Membuat konfigurasi atau template Anda lebih mudah dibaca dan dipecahkan masalahnya. Misalnya, jika Anda perlu mengonfigurasi beberapa aturan penerusan, Anda juga harus menentukan jaringan yang akan digunakan. Daripada memberikan link ke jaringan untuk setiap aturan penerusan, Anda dapat membuat referensi ke properti selfLink jaringan menggunakan sintaksis berikut:

  $(ref.network-name.selfLink)
  

  Jika Anda perlu memecahkan masalah konfigurasi, referensi ini akan mempermudah untuk mengetahui jaringan mana yang digunakan dalam aturan penerusan.

Saat membuat referensi ke resource, Anda juga membuat dependensi antar-resource. Misalnya, perhatikan cuplikan berikut, di mana sandbox-vm menggunakan referensi ke network-a:

resources:
- name: sandbox-vm
  type: compute.v1.instance
  properties:
    network: $(ref.network-a.selfLink)
    ...
...
- name: network-a
  type: compute.v1.network
  properties:
    ...

Saat Anda men-deploy konfigurasi ini, Deployment Manager akan membuat network-a sebelum sandbox-vm, sehingga referensi dapat diselesaikan. Jika ada referensi yang tidak berhasil diselesaikan, deployment Anda akan gagal.

Anda dapat menggunakan referensi dalam konfigurasi dan template.

Sebelum memulai

• Jika Anda ingin menggunakan contoh command line dalam panduan ini, instal alat command line`gcloud`.
• Jika Anda ingin menggunakan contoh API dalam panduan ini, siapkan akses API.
• Pahami cara membuat konfigurasi.
• Pahami cara membuat template dasar.

Membuat referensi dalam file konfigurasi

Deklarasikan referensi dalam konfigurasi Anda menggunakan format berikut:

$(ref.RESOURCE_NAME.PROPERTY)

Contoh berikut membuat jaringan, lalu membuat dua instance yang menggunakan referensi ke jaringan yang baru dibuat. Dalam contoh ini, referensinya adalah:

$(ref.a-new-network.selfLink)

# 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: the-first-vm
  type: compute.v1.instance
  properties:
    zone: us-central1-f
    machineType: https://www.googleapis.com/compute/v1/projects/MY_PROJECT/zones/us-central1-f/machineTypes/f1-micro
    disks:
    - deviceName: boot
      type: PERSISTENT
      boot: true
      autoDelete: true
      initializeParams:
        sourceImage: https://www.googleapis.com/compute/v1/projects/debian-cloud/global/images/family/debian-11
    networkInterfaces:
    # The resource's "network value" has been replaced with a
    # reference to the new network's "selfLink" property. The network 
    # resource has been added to the end of this file.
    - network: $(ref.a-new-network.selfLink)
      accessConfigs:
      - name: External NAT
        type: ONE_TO_ONE_NAT
- name: the-second-vm
  type: compute.v1.instance
  properties:
    zone: us-central1-f
    machineType: https://www.googleapis.com/compute/v1/projects/MY_PROJECT/zones/us-central1-f/machineTypes/g1-small
    disks:
    - deviceName: boot
      type: PERSISTENT
      boot: true
      autoDelete: true
      initializeParams:
        sourceImage: https://www.googleapis.com/compute/v1/projects/debian-cloud/global/images/family/debian-11
    networkInterfaces:
    # As in the resource above, the "network" value has been replaced with 
    # the new network's "selfLink" property. 
    - network: $(ref.a-new-network.selfLink)
      accessConfigs:
      - name: External NAT
        type: ONE_TO_ONE_NAT
# The following network is a new resource added to the "two-vms.yaml" file.
- name: a-new-network
  type: compute.v1.network
  properties:
    routingConfig:
      routingMode: REGIONAL
    autoCreateSubnetworks: true

Saat Anda men-deploy konfigurasi ini, jaringan dibuat sebelum dua instance, dan referensi diselesaikan ke selfLink resource jaringan.

Membuat referensi dalam template

Dalam file template, seluruh referensi harus didahului dengan $, lalu dimasukkan dalam satu set tanda kurung:

$(ref.RESOURCE_NAME.PROPERTY)

Anda dapat menggabungkan referensi dengan fitur lain seperti properti template dan variabel lingkungan. Untuk memastikan bahwa Deployment Manager mengurai referensi dengan benar, penting untuk diingat bahwa seluruh string referensi harus berada dalam tanda kurung.

Berikut beberapa contoh mendeklarasikan referensi dalam template Anda:

Langkah berikutnya

• Pratinjau konfigurasi Anda sebelum Anda berkomitmen untuk men-deploy-nya.
• Buat deployment.
• Pelajari lebih lanjut template.