Menambahkan NIC Dinamis ke instance

Untuk 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 instance yang ada dengan mengikuti petunjuk di Melihat antarmuka jaringan untuk instance.

Menambahkan Dynamic NIC

Bagian ini menjelaskan cara menambahkan NIC Dinamis ke instance.

Saat menambahkan NIC Dinamis, Anda mungkin mengamati penundaan penyebaran. 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 telah menambahkan NIC Dinamis ke instance yang langkah-langkahnya telah Anda selesaikan, Anda tidak perlu mengulanginya.

Untuk mengonfigurasi pengelolaan Dynamic NIC secara otomatis:

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, update lingkungan tamu.

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

3. Konfigurasikan 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 informasi tentang setelan ini, lihat hal 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 cara 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. Cantumkan antarmuka jaringan di instance Anda untuk melihat bahwa agen tamu Google telah 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 Dynamic NIC secara otomatis. Anda dapat menentukan apakah instance menjalankan agen tamu Google menggunakan perintah yang sesuai yang tercantum di Paket yang diinstal untuk lingkungan tamu.

   Untuk menonaktifkan pengelolaan Dynamic NIC secara otomatis:

   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 cara 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 nomor vNIC induk. Misalnya, 0 untuk nic0 atau 1 untuk nic1.

   2. Konfigurasikan 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 dapatkan di langkah sebelumnya