Elastic Compute Service:Instal cloud-init

Lihat dokumentasi resmi cloud-init.

Langkah 1: Periksa versi cloud-init

1. Masuk ke server sumber.

2. Periksa apakah cloud-init sudah terinstal.

   Seri CentOS

   rpm -qa | grep -i cloud-init 
   pip list | grep -i cloud-init

   Seri Ubuntu

   dpkg -l | grep -i cloud-init 
   pip list | grep -i cloud-init

   • Jika tidak ada output atau versinya sebelum 0.7.9, lihat Langkah 2: Instal cloud-init.

     Penting

     Versi 0.7.9 adalah versi komunitas awal yang tidak cocok untuk inisialisasi ECS. Lakukan upgrade ke versi yang lebih baru.

   • Jika versinya 18 atau lebih baru, tidak perlu instalasi. Untuk menyesuaikan konfigurasi jaringan default, lihat Nonaktifkan inisialisasi jaringan otomatis oleh Alibaba Cloud.

   • Jika versinya 19.1.21, lakukan upgrade ke Alibaba Cloud cloud-init 23.2.2. Peningkatan utama dibandingkan 19.1.21:

     • Mendukung akses metadata dalam mode security hardening. Lihat Instance metadata.

     • Perubahan lain mencakup peningkatan fitur, peningkatan performa, dan perbaikan bug. Lihat file ChangeLog.

   • Versi lainnya: tidak perlu instalasi. Lihat Langkah selanjutnya.

3. Untuk mencegah kehilangan data, backup data server sumber Anda sebelum instalasi. Misalnya, buat Snapshot.

Langkah 2: Instal cloud-init

• (Direkomendasikan) Alibaba Cloud cloud-init 23.2.2: Memerlukan Python 3.6 atau lebih baru. Sumber data: Aliyun.

• Alibaba Cloud cloud-init 19.1.21: Memerlukan Python 3.6 atau lebih baru. Sumber data: Aliyun.

• Alibaba Cloud cloud-init 0.7.6a18: Versi ini diperlukan untuk beberapa sistem operasi lama, seperti CentOS 6, Debian 9, dan SUSE Linux Enterprise Server 12. Versi ini memerlukan Python 2.7 dan menggunakan sumber data Aliyun.

  Penting

  Komunitas Python tidak lagi mendukung Python 2.7. Gunakan versi cloud-init yang lebih baru untuk menghindari potensi masalah dependensi pustaka.

• Versi komunitas cloud-init: Dipelihara oleh komunitas cloud-init. Versi terbaru Alibaba Cloud adalah 23.2.2. Untuk versi yang lebih baru, instal versi komunitas dari situs web resmi cloud-init.

Versi Alibaba Cloud dioptimalkan untuk layanan Alibaba Cloud. Gunakan versi Alibaba Cloud kecuali Anda memerlukan rilis komunitas yang lebih baru.

# Periksa dan instal python3-pip.
if ! python3 -c 'import setuptools' >& /dev/null; then
  yum -y install python3-pip
fi
# Backup versi lama cloud-init.
test -d /etc/cloud && mv /etc/cloud /etc/cloud-old
# Unduh dan ekstrak paket Alibaba Cloud cloud-init.
wget https://ecs-image-tools.oss-cn-hangzhou.aliyuncs.com/cloudinit/cloud-init-19.1.21.tgz
tar -zxvf ./cloud-init-19.1.21.tgz
# Instal cloud-init.
issue_major=$( cat /etc/redhat-release | grep -Eo '[0-9]+\.?[0-9]+' | head -1 | awk -F'.' '{printf $1}')
bash ./cloud-init-*/tools/deploy.sh centos "$issue_major"

# Periksa dan instal python3-pip.
if ! python3 -c 'import setuptools' >& /dev/null; then
  yum -y install python3-pip
fi
# Backup versi lama cloud-init.
test -d /etc/cloud && mv /etc/cloud /etc/cloud-old
# Unduh dan ekstrak paket Alibaba Cloud cloud-init.
wget https://ecs-image-tools.oss-cn-hangzhou.aliyuncs.com/cloudinit/cloud-init-19.1.21.tgz
tar -zxvf ./cloud-init-19.1.21.tgz
# Instal cloud-init.
issue_major=$( cat /etc/os-release | grep VERSION_ID | grep -Eo '[0-9]+\.?[0-9]+' | head -1 | awk -F'.' '{printf $1}')
bash ./cloud-init-*/tools/deploy.sh rhel "$issue_major"

# Periksa dan instal python3-pip.
if ! python3 -c 'import setuptools' >& /dev/null; then
  apt-get install python36 python3-pip -y
fi
# Backup versi lama cloud-init.
test -d /etc/cloud && mv /etc/cloud /etc/cloud-old
# Unduh dan ekstrak paket Alibaba Cloud cloud-init.
wget https://ecs-image-tools.oss-cn-hangzhou.aliyuncs.com/cloudinit/cloud-init-19.1.21.tgz
tar -zxvf ./cloud-init-19.1.21.tgz
# Instal cloud-init.
issue_major=$( cat /etc/os-release | grep VERSION_ID | grep -Eo '[0-9]+\.?[0-9]+' | head -1 | awk -F'.' '{printf $1}')
bash ./cloud-init-*/tools/deploy.sh ubuntu "$issue_major"

# Periksa dan instal python3-pip.
if ! python3 -c 'import setuptools' >& /dev/null; then
  apt-get -y install python3-pip
fi
# Backup versi lama cloud-init.
test -d /etc/cloud && mv /etc/cloud /etc/cloud-old
# Unduh dan ekstrak paket Alibaba Cloud cloud-init.
wget https://ecs-image-tools.oss-cn-hangzhou.aliyuncs.com/cloudinit/cloud-init-19.1.21.tgz
tar -zxvf ./cloud-init-19.1.21.tgz
# Instal cloud-init.
issue_major=$( cat /etc/os-release | grep VERSION_ID | grep -Eo '[0-9]+\.?[0-9]+' | head -1 | awk -F'.' '{printf $1}')
bash ./cloud-init-*/tools/deploy.sh debian "$issue_major"

# Periksa dan instal python3-pip.
if ! python3 -c 'import setuptools'>& /dev/null; then
  zypper -n install python3-pip
fi
# Backup versi lama cloud-init.
test -d /etc/cloud && mv /etc/cloud /etc/cloud-old
# Unduh dan ekstrak paket Alibaba Cloud cloud-init.
wget https://ecs-image-tools.oss-cn-hangzhou.aliyuncs.com/cloudinit/cloud-init-19.1.21.tgz
tar -zxvf ./cloud-init-19.1.21.tgz
# Instal cloud-init.
issue_major=$( cat /etc/os-release | grep VERSION_ID | grep -Eo '[0-9]+\.?[0-9]+' | head -1 | awk -F'.' '{printf $1}')
bash ./cloud-init-*/tools/deploy.sh sles "$issue_major"

# Periksa dan instal python3-pip.
if ! python3 -c 'import setuptools'>& /dev/null; then
  zypper -n install python3-pip
fi
# Backup versi lama cloud-init.
test -d /etc/cloud && mv /etc/cloud /etc/cloud-old
# Unduh dan ekstrak paket Alibaba Cloud cloud-init.
wget https://ecs-image-tools.oss-cn-hangzhou.aliyuncs.com/cloudinit/cloud-init-19.1.21.tgz
tar -zxvf ./cloud-init-19.1.21.tgz
# Instal cloud-init.
issue_major=$( cat /etc/os-release | grep VERSION_ID | grep -Eo '[0-9]+\.?[0-9]+' | head -1 | awk -F'.' '{printf $1}')
bash ./cloud-init-*/tools/deploy.sh opensuse "$issue_major"

(Opsional) Langkah 3: Konfigurasi cloud-init

FAQ

• Apa yang harus saya lakukan jika pustaka dependensi hilang saat menginstal cloud-init menggunakan Python 3?

  Pustaka yang hilang bervariasi tergantung gambar. Instal menggunakan pip, lalu instal cloud-init lagi.

• Apa yang harus saya lakukan jika cloud-init berjalan tidak normal dan mengembalikan pesan error?

  Jika manajer paket default (seperti yum) dan pip menginstal versi berbeda dari pustaka dependensi yang sama, konflik versi dapat menyebabkan cloud-init berjalan tidak normal. Unduh pustaka dependensi yang diperlukan berdasarkan pesan error.

  Pesan error	Penyebab	Perintah pemecahan masalah
  no setuptools module in python	Modul python setuptools tidak ada.	Untuk Python 3.6: CentOS/Red Hat: yum -y install python3-pip Ubuntu/Debian: apt-get -y install python3-pip OpenSUSE/SUSE: zypper -n install python3-pip
  File "/home/testuser/cloud-init/cloudinit/log.py", line 19, in <module> import six ImportError: No module named six )	Pustaka dependensi six tidak ada.	pip3 install six
  File "/home/testuser/cloud-init/cloudinit/url_helper.py", line 20, in <module> import oauthlib.oauth1 as oauth1 ImportError: No module named oauthlib.oauth1 )	Pustaka dependensi oauthlib tidak ada.	pip3 install oauthlib
  Pesan error tidak menentukan pustaka dependensi yang hilang.	Pesan error terkait tidak dipetakan.	Berdasarkan pustaka yang tercantum dalam file requirements.txt, instal semua pustaka dependensi: pip3 install -r requirements.txt

• Apa yang harus saya lakukan jika cloud-init berjalan tidak normal setelah versi baru Python 3 diinstal pada instans?

  Jika Anda menginstal versi baru Python 3, seperti Python 3.9, dan mengaturnya sebagai versi default dengan membuat tautan simbolik (misalnya, ln -s /usr/bin/python3.9 /usr/bin/python3), cloud-init yang terinstal mungkin berjalan tidak normal. Sebagai contoh, menjalankan cloud-init --version mengembalikan error:

  $cloud-init --version
  Traceback (most recent call last):
    File "/usr/local/bin/cloud-init", line 33, in <module>
      sys.exit(load_entry_point('cloud-init==19.1.9', 'console_scripts', 'cloud-init')())
    File "/usr/local/bin/cloud-init", line 22, in importlib_load_entry_point
      for entry_point in distribution(dist_name).entry_points
    File "/usr/lib64/python3.9/importlib/metadata.py", line 524, in distribution
      return Distribution.from_name(distribution_name)
    File "/usr/lib64/python3.9/importlib/metadata.py", line 187, in from_name
      raise PackageNotFoundError(name)
  importlib.metadata.PackageNotFoundError: cloud-init

  Gunakan salah satu metode berikut untuk mengatasi masalah ini:

  • Metode 1: Instal ulang cloud-init menggunakan versi baru Python 3.

  • Metode 2: Ubah file executable cloud-init untuk mengubah path interpreter Python ke versi Python 3 sebelumnya. Contoh berikut mengubah interpreter ke Python 3.6:

    1. Buka file cloud-init.

       vim   /usr/local/bin/cloud-init

    2. Tekan i untuk memasuki mode edit. Di awal file, ubah konten setelah #! menjadi path Python 3.6.

       Setelah dimodifikasi, baris yang dimulai dengan #! menjadi:

       #!/usr/bin/python3.6

    3. Tekan tombol Esc untuk keluar dari mode edit. Masukkan :wq lalu tekan Enter untuk menyimpan dan menutup file.

• Setelah saya menginstal cloud-init, mengapa instance user data yang saya atur saat pembuatan instans gagal dijalankan?

  1. Periksa apakah user data ada dalam metadata instans.

     curl http://100.100.100.200/latest/user-data

     Hasil:

     • Jika user data dikembalikan, lanjutkan ke langkah berikutnya untuk pemecahan masalah.

     • Jika tidak ada data yang dikembalikan, user data tidak diatur.

  2. Gunakan salah satu metode berikut untuk mengidentifikasi penyebabnya.

     • Periksa apakah format user data benar.

       User data dieksekusi oleh cloud-init dan harus dalam format yang benar. Misalnya, baris pertama harus dimulai dengan #!. Lihat Sesuaikan konfigurasi inisialisasi instans.

     • Periksa file log /var/log/cloud-init.log untuk mencari error dan pecahkan masalah berdasarkan pesan error tersebut.

       Contoh entri log:

        util.py[DEBUG]: Running command ['/var/lib/cloud/instance/scripts/part-001'] with allowed return codes [0] (shell=False, capture=False)

     • Lihat output standar dan output error standar dari eksekusi user data.

       Di systemd, user data dijalankan melalui cloud-final.service. Lihat output standar dan error-nya untuk pemecahan masalah:

       journalctl -u cloud-final.service

     • Jika metode di atas tidak mengidentifikasi masalahnya, salin user data ke host lokal untuk debugging.

• Setelah saya menginstal cloud-init, mengapa konfigurasi inisialisasi sistem dan skrip instance user data tidak berjalan seperti yang diharapkan?

  1. Periksa apakah keempat layanan cloud-init diaktifkan saat boot.

     systemctl is-enabled cloud-init-local.service
     systemctl is-enabled cloud-init.service
     systemctl is-enabled cloud-config.service
     systemctl is-enabled cloud-final.service

     Jika dikembalikan error atau disabled, cloud-init tidak diaktifkan saat boot.

  2. Aktifkan cloud-init saat boot.

     systemctl enable cloud-init-local.service
     systemctl enable cloud-init.service
     systemctl enable cloud-config.service
     systemctl enable cloud-final.service

• Saya mengubah ukuran sistem disk saat membuat instans, tetapi partisi root tidak diubah ukurannya secara otomatis. Apa yang harus saya lakukan?

  Pengubahan ukuran partisi otomatis untuk instans Linux memerlukan cloud-init. Pastikan growpart terinstal dan file cloud.cfg dikonfigurasi dengan benar.

  1. Periksa apakah growpart terinstal.

     which growpart

  2. (Diperlukan jika berlaku) Jika belum terinstal, instal.

     • Untuk seri RHEL:

       sudo yum -y install cloud-utils-growpart

     • Untuk seri Debian:

       sudo apt -y install cloud-guest-utils

  3. Periksa apakah file /etc/cloud/cloud.cfg berisi konten seperti di bawah ini.

     cat /etc/cloud/cloud.cfg

     

  4. (Diperlukan jika berlaku) Jika konten tersebut tidak ada, tambahkan ke file /etc/cloud/cloud.cfg.

• Untuk instans ECS dengan cloud-init 0.7.6a16 atau lebih lama, hostname tidak diperbarui setelah saya mengubahnya di konsol dan me-restart instans. Apa yang harus saya lakukan?

  • Deskripsi masalah

    Setelah Anda memperbarui hostname di Konsol ECS dan me-restart instans, hostname baru tidak berlaku. Perintah cloud-init --version menunjukkan versi 0.7.6a16 atau lebih lama.

  • Penyebab

    Saat cloud-init menggunakan modul update_hostname untuk memperbarui hostname, modul tersebut menjalankan perintah hostname untuk mendapatkan hostname sistem saat ini dan membaca /var/lib/cloud/data/previous-hostname untuk hostname yang di-cache. Modul tersebut membandingkan keduanya: jika sama, hostname diperbarui; jika berbeda, diasumsikan hostname diubah secara manual dan pembaruan dilewati.

    Pada sistem operasi berbasis Red Hat, konten yang dibaca dari /var/lib/cloud/data/previous-hostname mengandung line feed, tetapi output perintah hostname tidak. Ketidaksesuaian ini mencegah pembaruan hostname.

  • Solusi

    Gunakan salah satu solusi berikut:

    • Upgrade versi cloud-init. Lihat Langkah 2: Instal cloud-init.

      • Untuk CentOS 6 dan lebih lama, gunakan cloud-init 0.7.6a18.

      • Untuk CentOS 7, gunakan cloud-init 19.1.21.

      • Untuk CentOS 8 atau lebih baru, gunakan cloud-init 23.2.2 atau versi yang lebih baru.

    • Atasi line feed secara manual.

      Perbaiki secara manual file cloudinit/distros/rhel.py yang rusak di cloud-init (gunakan find / -name rhel.py untuk menemukan file tersebut). Rujuk distros/rhel.py: _read_hostname() missing strip on "hostname" untuk memproses line feed pada output perintah hostname:

      diff --git a/cloudinit/distros/rhel.py b/cloudinit/distros/rhel.py
      index 0b68414e..65176e99 100644
      --- a/cloudinit/distros/rhel.py
      +++ b/cloudinit/distros/rhel.py
      @@ -143,6 +143,7 @@ class Distro(distros.Distro):
                   return util.load_file(filename).strip()
               elif self.uses_systemd():
                   (out, _err) = util.subp(['hostname'])
      +            out = out.strip()
                   if len(out):
                       return out
                   else: