Menambahkan NIC Dinamis ke instance

Untuk mengetahui informasi tentang cara membuat instance baru, lihat Membuat VM dengan beberapa antarmuka jaringan.

Sebelum memulai

Sebelum menambahkan NIC Dinamis ke instance, lakukan hal berikut:

• Pastikan Anda memahami properti dan batasan NIC Dinamis seperti yang dijelaskan dalam ringkasan beberapa antarmuka jaringan.
• Jika perlu, lihat antarmuka jaringan yang ada di instance Anda dengan mengikuti petunjuk di Melihat antarmuka jaringan untuk instance.

Menambahkan NIC Dinamis

Bagian ini menjelaskan cara menambahkan NIC Dinamis ke instance.

Saat menambahkan NIC Dinamis, Anda mungkin mengamati jeda propagasi. Penundaan ini biasanya berlangsung selama beberapa detik, tetapi terkadang juga dapat berlangsung hingga satu menit.

gcloud beta compute instances network-interfaces add INSTANCE_NAME \
   --zone=ZONE \
   --vlan=VLAN_ID \
   --parent-nic-name=PARENT_VNIC_NAME \
   --network=NETWORK \
   --subnetwork=SUBNET

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/addNetworkInterface
{
  "subnetwork": "regions/REGION/subnetworks/SUBNET",
  "parentNicName": "PARENT_VNIC_NAME",
  "vlan": "VLAN_ID"
}

Mengonfigurasi OS tamu untuk NIC Dinamis

Bagian ini menjelaskan cara menyelesaikan konfigurasi OS tamu tambahan yang diperlukan saat Anda menambahkan NIC Dinamis ke instance baru atau yang sudah ada.

Pilih salah satu opsi konfigurasi berikut:

Mengonfigurasi pengelolaan otomatis NIC Dinamis

Bagian ini menjelaskan cara mengonfigurasi pengelolaan otomatis NIC Dinamis menggunakan agen tamu Google.

Anda hanya perlu menyelesaikan langkah-langkah ini satu kali per instance. Jika Anda menambahkan NIC Dinamis ke instance yang sudah menyelesaikan langkah-langkah ini, Anda tidak perlu mengulanginya.

Untuk mengonfigurasi pengelolaan otomatis NIC Dinamis:

1. Hubungkan ke instance menggunakan SSH.

2. Pastikan instance menjalankan agen tamu Google pada versi 20250204.02 atau yang lebih baru:

   1. Untuk menentukan apakah instance menjalankan agen tamu Google, jalankan perintah yang sesuai yang tercantum di Paket yang diinstal untuk lingkungan tamu.

      1. Jika instance Anda tidak menjalankan agen tamu Google, instal lingkungan tamu.

      2. Jika instance Anda menjalankan agen tamu Google, perbarui lingkungan tamu.

      Menginstal atau mengupdate lingkungan tamu memastikan Anda memiliki agen tamu Google versi terbaru. Anda dapat mengonfirmasi versi dengan mengikuti langkah-langkah di Memvalidasi lingkungan tamu.

3. Konfigurasi agen tamu Google untuk mengelola NIC Dinamis:

   1. Buka atau buat file konfigurasi lingkungan tamu Anda.

      edit /etc/default/instance_configs.cfg
      

   2. Tambahkan kode berikut ke file konfigurasi, lalu simpan perubahan dan keluar dari editor.

      [NetworkInterfaces]
      vlan_setup_enabled = true
      manage_primary_nic = true
      

      Untuk mengetahui informasi tentang setelan ini, lihat berikut:

      • vlan_setup_enabled = true: mengonfigurasi agen tamu Google untuk menginstal dan mengelola NIC Dinamis
      • manage_primary_nic = true: setelan tambahan yang diperlukan agar agen tamu Google dapat mengelola NIC Dinamis yang dibuat di nic0

      Untuk mengetahui informasi selengkapnya tentang mengedit file konfigurasi agen tamu, lihat Konfigurasi dalam dokumentasi agen tamu Google.

   3. Mulai ulang agen tamu dengan menjalankan perintah berikut. Atau, Anda dapat memulai ulang instance.

      sudo systemctl restart google-guest-agent.service
      

4. Buat daftar antarmuka jaringan di instance Anda untuk melihat bahwa agen tamu Google menginstal NIC Dinamis Anda.

   Misalnya, perintah berikut menampilkan nama seperti a-gcp.ens4.11 untuk NIC Dinamis dengan ID VLAN 11 yang dibuat sebagai turunan dari antarmuka ens4.

   sudo ip -d addr
   

Mengonfigurasi OS tamu secara manual

Untuk mengonfigurasi NIC Dinamis di OS tamu instance secara manual:

1. Hubungkan ke instance menggunakan SSH.

2. Jika instance menjalankan agen tamu Google, nonaktifkan pengelolaan NIC Dinamis secara otomatis. Anda dapat menentukan apakah instance menjalankan agen tamu Google dengan menggunakan perintah yang sesuai yang tercantum di Paket yang diinstal untuk lingkungan tamu.

   Untuk menonaktifkan pengelolaan otomatis NIC Dinamis:

   1. Buka atau buat file konfigurasi lingkungan tamu Anda.

        edit /etc/default/instance_configs.cfg
        

   2. Tambahkan kode berikut ke file konfigurasi, lalu simpan perubahan dan keluar dari editor.

      [NetworkInterfaces]
      vlan_setup_enabled = false
      manage_primary_nic = false
      

      Untuk mengetahui informasi selengkapnya tentang mengedit file konfigurasi agen tamu, lihat Konfigurasi dalam dokumentasi agen tamu Google.

   3. Mulai ulang agen tamu dengan menjalankan perintah berikut. Atau, Anda dapat memulai ulang instance.

      sudo systemctl restart google-guest-agent.service
      

3. Untuk setiap NIC Dinamis yang Anda buat, lakukan hal berikut:

   1. Dapatkan alamat MAC vNIC induk. Untuk menemukan alamat MAC, buat kueri server metadata dengan menjalankan perintah berikut:

      curl http://metadata.google.internal/computeMetadata/v1/instance/network-interfaces/VNIC_NUMBER/mac -H "Metadata-Flavor: Google"
      

      Ganti VNIC_NUMBER dengan jumlah vNIC induk. Misalnya, 0 untuk nic0 atau 1 untuk nic1.

   2. Konfigurasi subantarmuka di OS tamu instance. Misalnya, di VM Debian, jalankan perintah berikut:

      sudo modprobe 8021q
      sudo ip link add link VNIC_NAME name VNIC_NAME.VLAN_ID type vlan id VLAN_ID
      sudo ip addr add IP_ADDRESS dev VNIC_NAME.VLAN_ID
      sudo ip link set dev VNIC_NAME.VLAN_ID address MAC_ADDRESS
      sudo ip link set up VNIC_NAME.VLAN_ID
      

      Ganti kode berikut:

      • VNIC_NAME: nama vNIC induk yang ditetapkan oleh sistem operasi, seperti eth1 atau ens4
      • IP_ADDRESS: alamat IP NIC Dinamis yang Anda buat
      • VLAN_ID: ID VLAN yang Anda tetapkan ke NIC Dinamis
      • MAC_ADDRESS: alamat MAC yang Anda peroleh pada langkah sebelumnya