Membuat dan mengonfigurasi instance

Ada dua cara untuk membuat dan mengonfigurasi instance Compute Engine yang menjalankan Container-Optimized OS dari Google.

Untuk skenario sederhana saat Anda ingin menjalankan satu container di VM atau di setiap VM dalam grup instance terkelola, Anda dapat menentukan image container dan parameter konfigurasi opsional saat Anda menentukan instance atau template instance. Compute Engine membuat instance dengan versi terbaru Container-Optimized OS dan meluncurkan container yang ditentukan saat VM dimulai.

Catatan: Fitur Compute Engine yang men-deploy container di VM selama pembuatan VM sudah tidak digunakan lagi. Gunakan perintah docker run dalam skrip startup atau gunakan alat cloud-init untuk mengonfigurasi dan menjalankan container di VM dan MIG Anda. Untuk mengetahui informasi selengkapnya, lihat Memigrasikan container yang di-deploy di VM selama pembuatan VM.

Untuk skenario lanjutan di mana Anda dapat men-deploy beberapa container dan mengonfigurasi opsi Docker menggunakan cloud-init, Anda dapat membuat instance Compute Engine dengan pilihan image Container-Optimized OS, lalu melanjutkan untuk mengonfigurasi container sesuai kebutuhan.

Membuat instance sederhana

Gunakan metode ini untuk men-deploy satu container di VM menggunakan versi terbaru Container-Optimized OS. Anda dapat melakukan tugas ini menggunakan konsol Google Cloud atau gcloud CLI.

Konsol

Catatan: Opsi Deploy container di konsol Google Cloud tidak digunakan lagi. Gunakan perintah docker run yang setara untuk mengonfigurasi dan menjalankan container.

1. Buka halaman VM instances.

   Buka halaman VM instances

2. Klik Create instance.

3. Tentukan Nama untuk instance Anda.

4. Di bagian Container, pilih kotak centang Deploy a container image to this VM instance.

5. Tentukan Image container yang akan digunakan.

   • Anda dapat menentukan image dari Container Registry atau Artifact Registry. Contoh:
     • gcr.io/cloud-marketplace/google/nginx1:1.15 memilih image container NGINX 1.15 dari Google Cloud Marketplace.
     • us-docker.pkg.dev/google-samples/containers/gke/hello-app:1.0 memilih sampel image hello-app dari Artifact Registry.
   • Jika Anda menggunakan image container dari Docker Hub, selalu tentukan nama lengkap image Docker. Misalnya, tentukan nama image berikut untuk men-deploy image container Apache: docker.io/httpd:2.4.

6. Secara opsional, klik Opsi container lanjutan. Untuk informasi selengkapnya, lihat Mengonfigurasi Opsi untuk Menjalankan Container Anda.

7. Klik Create untuk membuat instance, melakukan booting pada instance, dan meluncurkan container.

gcloud

Catatan: Perintah gcloud CLI create-with-container tidak digunakan lagi. Gunakan perintah docker run yang setara untuk mengonfigurasi dan menjalankan container.

Untuk membuat instance VM dasar, jalankan perintah berikut:

gcloud compute instances create-with-container instance-name \
    --container-image image-name

Ganti kode berikut:

• instance-name: nama untuk instance baru.
• image-name: nama image container.

Misalnya, perintah berikut membuat instance VM baru bernama nginx-vm, yang akan meluncurkan dan menjalankan image container gcr.io/cloud-marketplace/google/nginx1:1.15:

gcloud compute instances create-with-container nginx-vm \
    --container-image gcr.io/cloud-marketplace/google/nginx1:1.15

Demikian pula, Anda dapat membuat instance VM baru bernama hello-app yang akan meluncurkan dan menjalankan container contoh di Artifact Registry:

gcloud compute instances create-with-container hello-app \
--container-image us-docker.pkg.dev/google-samples/containers/gke/hello-app:1.0

Saat menggunakan image container dari Docker Hub, Anda harus selalu menentukan nama lengkap image Docker. Misalnya, tentukan nama image berikut untuk men-deploy image container Apache:

docker.io/httpd:2.4

Untuk menjalankan satu container di setiap VM dalam grup instance terkelola, tentukan nama image container saat menentukan template instance. Lihat Membuat template instance dengan image container untuk mengetahui informasi selengkapnya.

Membuat instance untuk skenario lanjutan

Gunakan metode ini untuk memilih image Container-Optimized OS tertentu, men-deploy beberapa container, dan menggunakan cloud-init untuk konfigurasi lanjutan.

Melihat gambar yang tersedia

Image Container-Optimized OS tersedia di Google Cloud konsol dalamdaftar image dengan awalan cos. Fungsi ini dihosting di project cos-cloud. Anda juga dapat melihat semua rilis yang tersedia saat ini di command line dengan menjalankan perintah berikut:

gcloud compute images list --project cos-cloud --no-standard-images

Outputnya mirip dengan hal berikut ini:

NAME                       PROJECT    FAMILY      DEPRECATED  STATUS
cos-69-10895-385-0         cos-cloud  cos-69-lts              READY
cos-73-11647-534-0         cos-cloud  cos-73-lts              READY
cos-77-12371-251-0         cos-cloud  cos-77-lts              READY
cos-81-12871-103-0         cos-cloud  cos-81-lts              READY
cos-beta-81-12871-44-0     cos-cloud  cos-beta                READY
cos-dev-84-13078-0-0       cos-cloud  cos-dev                 READY
cos-stable-81-12871-103-0  cos-cloud  cos-stable              READY

Catatan: Image Container-Optimized OS terbaru kini tersedia di project cos-cloud, dan menggunakan awalan nama cos. Image ini identik dengan versi Container-Optimized OS sebelumnya, yang menggunakan awalan nama gci dan dapat diakses melalui project google-containers. Image gci dalam project google-containers dianggap tidak digunakan lagi.
Versi terbaru image Container-Optimized OS kini hanya di-push ke project cos-cloud; perbarui alur kerja pengembangan atau produksi Anda untuk menggunakan image cos di cos-cloud guna mendapatkan rilis terbaru.

Membuat instance

Anda dapat membuat instance menggunakan Google Cloud konsol, gcloud CLI, atau API.

Konsol

Catatan: Opsi Deploy container di konsol Google Cloud tidak digunakan lagi. Gunakan perintah docker run yang setara untuk mengonfigurasi dan menjalankan container.

Untuk menjalankan instance Compute Engine dengan Container-Optimized OS dan Docker terinstal, lakukan langkah-langkah berikut:

1. Buka halaman pembuatan instance Compute Engine di konsol Google Cloud .

   Buat instance Compute Engine baru

2. Tentukan Nama untuk instance Anda.

3. Di bagian Containers, hapus centang pada kotak Deploy a container image to this VM instance. Opsi ini berguna jika Anda ingin men-deploy satu container di VM.

4. Di bagian Boot disk, pilih image Container-Optimized OS.

5. Klik Create untuk membuat dan mem-boot instance.

gcloud

Catatan: Perintah gcloud CLI create-with-container tidak digunakan lagi. Gunakan perintah docker run yang setara untuk mengonfigurasi dan menjalankan container.

Tinjau image yang tersedia, lalu gunakan perintah berikut untuk membuat instance image node cos:

gcloud compute instances create instance-name \
    --image image-name \
    --image-project cos-cloud \
    --zone compute-zone \
    --machine-type machine-type-name

Ganti kode berikut:

• instance-name: nama instance VM Anda.
• image-name: nama image Container-Optimized OS untuk instance, yang diperoleh dari daftar image yang tersedia. Dari contoh sebelumnya, kita dapat menggunakan cos-beta-81-12871-44-0.
• compute-zone: zona komputasi untuk instance Anda.
• machine-type-name: jenis mesin yang akan digunakan untuk instance baru ini. Jenis defaultnya adalah n1-standard-1.

Misalnya, perintah berikut membuat instance bernama cos-test menggunakan image cos-beta-67-10575-13-0:

gcloud compute instances create cos-test \
    --image cos-beta-67-10575-13-0 \
    --image-project cos-cloud \
    --zone us-east1-d \
    --machine-type n1-standard-1

Anda dapat menambahkan tanda --preemptible untuk instance eksperimental sekali pakai.

API

Di API, buat permintaan normal untuk membuat instance, tetapi sertakan image sumber Container-Optimized OS. Contoh:

POST https://compute.googleapis.com/compute/v1/projects/project-id/zones/compute-zone/instances

{
  'machineType': 'zones/compute-zone/machineTypes/machine-type-name',
  'name': 'instance-name',
  'networkInterfaces': [
    {
      'accessConfigs': [
        {
          'type': 'ONE_TO_ONE_NAT',
          'name': 'External NAT'
        }
      ],
      'network': 'global/networks/default'
    }
  ],
  'disks': [
    {
      'type': 'PERSISTENT',
      'boot': true,
      'autoDelete': true,
      'initializeParams': {
        'sourceImage': 'projects/cos-cloud/global/images/image-name'
      }
    }
  ]
}

Mengonfigurasi instance

Dalam beberapa kasus, Anda mungkin ingin melakukan konfigurasi tambahan saat instance melakukan booting. Anda dapat menggunakan alat cloud-init dengan Container-Optimized OS untuk menerapkan informasi konfigurasi yang Anda berikan dalam format cloud-config.

Menggunakan cloud-init dengan format Cloud config

Image Container-Optimized OS menyertakan cloud-init sebagai cara untuk mengonfigurasi instance saat dimulai. Alat cloud-init mengharapkan konfigurasinya dalam nilai kunci user-data dari metadata instance. Alat cloud-init memahami beberapa format.

Berikut adalah contoh file cloud-init yang menunjukkan cara membuat akun pengguna dan membuat layanan systemd yang dimiliki oleh pengguna ini yang mengontrol pengelolaan penampung busybox Docker:

#cloud-config

users:
- name: cloudservice
  uid: 2000

write_files:
- path: /etc/systemd/system/cloudservice.service
  permissions: 0644
  owner: root
  content: |
    [Unit]
    Description=Start a simple docker container

    [Service]
    ExecStart=/usr/bin/docker run --rm -u 2000 --name=mycloudservice busybox:latest /bin/sleep 3600
    ExecStop=/usr/bin/docker stop mycloudservice
    ExecStopPost=/usr/bin/docker rm mycloudservice

runcmd:
- systemctl daemon-reload
- systemctl start cloudservice.service

# Optional once-per-boot setup. For example: mounting a PD.
bootcmd:
- fsck.ext4 -tvy /dev/[DEVICE_ID]
- mkdir -p /mnt/disks/[MNT_DIR]
- mount -t ext4 -O ... /dev/[DEVICE_ID] /mnt/disks/[MNT_DIR]

Catatan: Penggunaan systemctl enable di bagian runcmd cloud-init tidak akan berfungsi sebagaimana mestinya. Hal ini karena /etc di Container-Optimized OS bersifat stateless, sehingga perintah seperti systemctl enable/disable, yang mengubah /etc, tidak akan dipertahankan saat dimulai ulang. Lihat Disk dan Sistem File untuk mengetahui informasi selengkapnya tentang sistem file Container-Optimized OS. Alternatif untuk systemctl enable adalah menggunakan systemctl start, seperti dalam contoh di atas. Modul cloud-init seperti write_files dan runcmd, yang biasanya dijalankan sekali per instance pada distro lain, dijalankan pada setiap booting di Container-Optimized OS.

Catatan: Opsi uid di bagian users adalah ekstensi image node cos. Opsi ini tidak akan berfungsi dengan versi cloud-init lainnya. Opsi ini secara eksplisit menetapkan ID untuk pengguna dan memungkinkan Anda memastikan ID konsisten di antara berbagai instance. Sebaiknya Anda selalu menyetel opsi ini. Pilih ID dari rentang [2000, 4999] untuk menghindari konflik dengan akun pengguna lain.

Untuk membuat instance VM Container-Optimized OS yang mereferensikan file cloud-init ini, gunakan flag command line --metadata-from-file. Dengan asumsi file cloud-init bernama filename di direktori saat ini, perintah berikut akan membuat instance Container-Optimized OS dan memicu cloud-init dengan menetapkan konten file ke kunci user-data di Metadata Instance:

gcloud compute instances create instance-name \
    --image image-name \
    --image-project cos-cloud \
    --metadata-from-file user-data=filename

Ganti kode berikut:

• instance-name: nama instance VM Anda.
• image-name: nama image Container-Optimized OS untuk instance. Contoh, --image=cos-113-18244-85-29.
• filename: nama file metadata.

Anda dapat menetapkan flag metadata lain saat membuat instance Container-Optimized OS. Karena properti ini adalah pasangan nilai kunci sederhana, Anda dapat menggunakan flag --metadata dalam perintah gcloud compute instances create untuk membuat properti. Selain itu, mulai dari milestone 97, Anda dapat menetapkan flag metadata di metadata project menggunakan flag --metadata dalam perintah gcloud compute project-info add-metadata. Flag yang ditentukan di tingkat instance akan lebih diutamakan daripada flag yang ditentukan di tingkat project.

Contoh sebelumnya dapat diperluas untuk mengumpulkan statistik penggunaan dan pengumpulan dump error dengan perintah berikut:

gcloud compute instances create instance-name \
    --image image-name \
    --image-project cos-cloud \
    --metadata-from-file user-data=filename \
    --metadata=cos-metrics-enabled=true

Flag metadata lainnya

Kunci Metadata	Deskripsi	Perilaku Default
cos-update-strategy	Menentukan perilaku update otomatis. Nilainya bisa berupa update_enabled, update_disabled, atau tidak disetel. Jika tidak disetel, perilaku update otomatis default untuk tonggak pencapaian akan digunakan. Jika diaktifkan, perilaku bergantung pada saluran rilis: cos-dev dan cos-beta: Update dari versi OS terbaru dalam kelompok image yang sesuai Tonggak pencapaian LTS dan cos-stable: Update dari versi OS terbaru dari tonggak pencapaian yang sama	Tonggak pencapaian < 117: Diaktifkan secara default Tonggak pencapaian >= 117: Dinonaktifkan secara default
cos-metrics-enabled	Mengaktifkan pengumpulan dump error. Nilainya bisa berupa: true false (default).	Dinonaktifkan secara default

Perhatian: Mengaktifkan setelan cos-metrics-enabled mengizinkan pengumpulan beberapa laporan error yang membantu Google meningkatkan kualitas gambar node cos. Laporan error berisi cuplikan bagian terbaru dari buffer log kernel pada saat error terjadi, dan dapat berisi informasi pengguna atau pribadi, bergantung pada apa yang terjadi saat error terjadi. Informasi tersebut dikirim langsung ke Google dan tidak dibagikan ke luar Google.

Menghubungkan ke instance

Anda dapat melakukan SSH ke instance VM yang menjalankan image node cos dengan cara yang sama seperti saat Anda melakukan SSH ke instance Compute Engine lainnya.

Contoh:

gcloud compute ssh instance-name \
    --project project-id \
    --zone compute-zone

Menjalankan skrip startup

Anda dapat menentukan skrip startup melalui server metadata, menggunakan kunci metadata startup-script. Anda dapat menggunakan Google Cloud CLI, API, atau konsol Google Cloud untuk menyediakan skrip startup. Lihat Menjalankan Skrip Startup untuk mengetahui detailnya.

Sinkronisasi waktu

Sebelum milestone 85, Container-Optimized OS menggunakan layanan systemd-timesyncd systemd untuk menyinkronkan jam sistem lokal dengan server Network Time Protocol (NTP) jarak jauh melalui protokol SNTP. Entri berikut dalam file konfigurasi /etc/systemd/timesyncd.conf menampilkan nilai konfigurasi default yang diberi komentar untuk membantu administrator melakukan perubahan yang diinginkan:

cat /etc/systemd/timesyncd.conf
# comments omitted for brevity
[Time]
#NTP=
#FallbackNTP=metadata.google.internal
#RootDistanceMaxSec=5
#PollIntervalMinSec=32
#PollIntervalMaxSec=2048

Jadi, jarak root maksimum yang dapat diterima adalah 5 detik dan interval polling minimum dan maksimum untuk pesan NTP adalah 32 dan 2048 detik.

Mulai dari tonggak pencapaian 85, Container-Optimized OS menggunakan layanan chronyd untuk menyinkronkan clock sistem lokal dengan server Network Time Protocol (NTP) jarak jauh melalui protokol NTP. Entri berikut dalam file konfigurasi /etc/chrony/chrony.conf menampilkan nilai konfigurasi default yang diberi komentar untuk membantu administrator melakukan perubahan yang diinginkan:

cat /etc/chrony/chrony.conf
# Use custom NTP servers
server metadata.google.internal prefer iburst

# Record the rate at which the system clock gains/losses time.
driftfile /var/lib/chrony/drift

# Allow the system clock to be stepped in the first three updates
# if its offset is larger than 1 second.
makestep 1.0 3

# Enable kernel synchronization of the real-time clock (RTC).
rtcsync

Server NTP ditetapkan dari respons DHCP eth0, yang biasanya merupakan server metadata Compute Engine:

networkctl status eth0 | grep NTP
             NTP: 169.254.169.254

Mengubah zona waktu

Zona waktu default Container-Optimized OS dari Google adalah UTC0. Buat link simbolis ke zona waktu yang diinginkan seperti pada contoh berikut:

sudo rm /etc/localtime
sudo ln -s /usr/share/zoneinfo/US/Pacific /etc/localtime

Perhatikan bahwa /etc tidak memiliki status, sehingga zona waktu akan direset ke default (UTC0) setiap kali dimulai ulang.

Mengaktifkan atau menonaktifkan update otomatis

Ada dua cara untuk mengaktifkan atau menonaktifkan update otomatis. Metode yang lebih disukai adalah menetapkan kunci metadata instance cos-update-strategy ke update_enabled atau update_disabled. Contoh:

gcloud compute instances create instance-name \
    --image image-name \
    --image-project cos-cloud \
    --metadata cos-update-strategy=update_disabled

Mulai dari milestone 97, Anda juga dapat menonaktifkan atau mengaktifkan update otomatis di metadata project:

gcloud compute project-info add-metadata \
    --metadata cos-update-strategy=update_disabled

Catatan: Flag metadata yang ditentukan di tingkat instance lebih diutamakan daripada flag metadata yang ditentukan di tingkat project.

Anda juga dapat menonaktifkan update otomatis pada instance yang sedang berjalan dengan systemctl:

sudo systemctl stop update-engine
sudo systemctl mask update-engine