Elastic Compute Service：Instal cloud-init

Untuk informasi lebih lanjut tentang cloud-init, lihat dokumentasi resmi cloud-init.

Langkah 1: Periksa apakah akan menginstal atau meningkatkan cloud-init

1. Masuk ke server sumber.

2. Jalankan perintah berikut untuk memeriksa apakah cloud-init telah diinstal.

   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 yang dikembalikan atau versinya lebih lama dari 0.7.9: Lanjutkan ke Langkah 2: Instal cloud-init.

     Penting

     Versi 0.7.9 adalah versi komunitas awal dari cloud-init yang tidak cocok untuk inisialisasi Instance ECS. Anda harus meningkatkannya ke versi yang lebih baru.

   • Jika versinya 18 atau lebih baru: Anda tidak perlu menginstal cloud-init. Namun, cloud-init secara otomatis mengonfigurasi jaringan selama inisialisasi instans. Jika konfigurasi default tidak memenuhi kebutuhan Anda, Anda dapat menonaktifkan fitur inisialisasi jaringan. Untuk informasi lebih lanjut, lihat Nonaktifkan inisialisasi jaringan otomatis oleh Alibaba Cloud.

   • Jika versinya 19.1.21: Tingkatkan ke Alibaba Cloud cloud-init 23.2.2. Alibaba Cloud cloud-init 23.2.2 memberikan peningkatan dan fitur baru berikut dibandingkan dengan versi 19.1.21:

     • Instans yang menggunakan cloud-init 23.2.2 mendukung akses ke metadata dalam mode Penguatan Keamanan. Untuk informasi lebih lanjut tentang metadata instans, lihat Metadata Instans.

     • Perubahan lainnya mencakup peningkatan fitur, perbaikan kinerja, perbaikan bug, dan kontribusi komunitas. Untuk informasi lebih lanjut, lihat file ChangeLog.

   • Versi lainnya: Anda tidak perlu menginstal cloud-init. Lanjutkan ke Langkah selanjutnya.

3. Untuk mencegah kehilangan data akibat operasi yang salah selama instalasi, kami sarankan Anda terlebih dahulu mencadangkan data server sumber Anda. Sebagai contoh, Anda dapat membuat Snapshot.

Langkah 2: Instal cloud-init

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

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

• Alibaba Cloud cloud-init 0.7.6a17: Versi ini diperlukan untuk beberapa sistem operasi yang lebih lama, seperti CentOS 6, Debian 9, dan SUSE Linux Enterprise Server 12. Memerlukan Python 2.7. Sumber data adalah Aliyun.

  Penting

  Karena komunitas Python tidak lagi memberikan dukungan teknis untuk Python 2.7, kami menyarankan Anda menggunakan versi cloud-init yang lebih baru untuk menghindari masalah potensial dengan pustaka dependensi.

• Versi komunitas cloud-init: Versi komunitas dipelihara oleh komunitas cloud-init. Versi terbaru dari Alibaba Cloud cloud-init adalah 23.2.2. Jika Anda membutuhkan versi yang lebih baru, Anda dapat menginstal versi komunitas. Untuk informasi versi lebih lanjut, lihat situs resmi cloud-init.

Versi komunitas cloud-init adalah versi resmi dari proyek tersebut. Versi Alibaba Cloud dioptimalkan untuk platform Alibaba Cloud dan memberikan dukungan yang lebih baik untuk layanannya. Oleh karena itu, kami menyarankan Anda menggunakan versi Alibaba Cloud dari cloud-init. Anda dapat memilih versi untuk diinstal berdasarkan kebutuhan Anda.

# Periksa dan instal python3-pip.
if ! python3 -c 'import setuptools' >& /dev/null; then
  yum -y install python3-pip
fi
# Cadangkan 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
# Cadangkan 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
# Cadangkan 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
# Cadangkan 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
# Cadangkan 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
# Cadangkan 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 tidak ditemukan saat saya menginstal cloud-init menggunakan Python 3?

  Pustaka yang hilang dapat bervariasi tergantung pada citra. Anda dapat menginstalnya menggunakan pip dan kemudian menginstal cloud-init lagi.

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

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

  Pesan kesalahan	Penyebab	Perintah pemecahan masalah
  no setuptools module in python	Modul python setuptools tidak ditemukan.	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 ditemukan.	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 ditemukan.	pip3 install oauthlib
  Pesan kesalahan tidak menentukan pustaka dependensi yang hilang.	Pesan kesalahan terkait tidak dipetakan.	Berdasarkan daftar pustaka dalam file requirements.txt milik cloud-init, jalankan perintah berikut untuk menginstal 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, pada instans dan menyetelnya 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, ketika Anda menjalankan perintah cloud-init --version, sebuah kesalahan dilaporkan:

  $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

  Anda dapat menggunakan salah satu metode berikut untuk menyelesaikan masalah ini:

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

  • Metode 2: Modifikasi file yang dapat dieksekusi cloud-init untuk mengubah path interpreter Python ke path versi sebelumnya Python 3. Contoh berikut menunjukkan cara mengubah interpreter dalam file yang dapat dieksekusi cloud-init menjadi Python 3.6:

    1. Jalankan perintah berikut untuk membuka file cloud-init.

       vim   /usr/local/bin/cloud-init

    2. Tekan i untuk masuk ke mode edit. Di awal file, ubah konten setelah #! ke path tempat Python 3.6 berada.

       Setelah dimodifikasi, baris yang dimulai dengan #! akan tampak seperti berikut:

       #!/usr/bin/python3.6

    3. Tekan tombol Esc untuk keluar dari mode edit. Kemudian, masukkan :wq dan tekan tombol Enter untuk menyimpan dan menutup file.

• Setelah saya menginstal cloud-init, mengapa data pengguna instans yang saya atur selama pembuatan instans gagal dijalankan?

  1. Jalankan perintah berikut pada instans untuk memeriksa apakah data pengguna ada dalam metadata instans.

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

     Deskripsi hasil:

     • Jika data pengguna diatur, data pengguna akan dikembalikan. Anda harus melanjutkan ke langkah berikutnya untuk memecahkan masalah.

     • Jika tidak ada informasi yang dikembalikan, Anda tidak mengatur data pengguna.

  2. Gunakan salah satu metode berikut untuk mengidentifikasi alasan mengapa data pengguna gagal dijalankan.

     • Periksa apakah data pengguna dalam format yang benar.

       Data pengguna dijalankan oleh cloud-init. Anda harus memastikan bahwa format datanya benar. Misalnya, baris pertama data pengguna harus dimulai dengan #!. Untuk informasi lebih lanjut, lihat Kustomisasi konfigurasi inisialisasi instans.

     • Periksa hasil eksekusi data pengguna dalam file log /var/log/cloud-init.log milik cloud-init dan pecahkan masalah berdasarkan pesan kesalahan.

       Berikut adalah contoh informasi yang dicatat dalam file 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 kesalahan standar dari proses eksekusi data pengguna.

       Dalam systemd, alat inisialisasi sistem Linux, data pengguna dijalankan oleh layanan sistem `cloud-final.service`. Anda dapat menjalankan perintah berikut untuk melihat output standar dan output kesalahan standar dari proses eksekusi data pengguna dan memecahkan masalah berdasarkan output tersebut.

       journalctl -u cloud-final.service

     • Jika Anda tidak dapat mengidentifikasi alasan mengapa data pengguna gagal dijalankan menggunakan metode sebelumnya, Anda dapat menyalin konten data pengguna ke host lokal untuk debugging untuk memeriksa apakah dapat dijalankan dengan sukses.

• Setelah saya menginstalcloud-init, mengapa konfigurasi inisialisasi sistem dan skrip data pengguna instans tidak berjalan sesuai harapan?

  1. Jalankan perintah berikut untuk memeriksa apakah empat layanan cloud-init diaktifkan untuk mulai 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 pesan kesalahan atau pesan disabled dikembalikan, cloud-init tidak diaktifkan untuk mulai saat boot.

  2. Jalankan perintah berikut untuk mengaktifkan cloud-init agar mulai 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 disk sistem saat saya membuat instans, tetapi partisi root tidak secara otomatis diubah ukurannya. Apa yang harus saya lakukan?

  Penyesuaian ukuran partisi otomatis untuk instans Linux didukung oleh cloud-init. Pastikan alat `growpart` terinstal pada sistem dan file cloud.cfg dikonfigurasi dengan benar.

  1. Jalankan perintah berikut untuk memeriksa apakah alat `growpart` terinstal pada sistem.

     which growpart

  2. (Diperlukan jika berlaku) Jika alat tersebut tidak terinstal, jalankan salah satu perintah berikut untuk menginstalnya.

     • Seri RHEL:

       sudo yum -y install cloud-utils-growpart

     • Seri Debian:

       sudo apt -y install cloud-guest-utils

  3. Jalankan perintah berikut untuk memeriksa apakah file /etc/cloud/cloud.cfg berisi konten yang ditampilkan pada gambar berikut.

     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, nama host tidak diperbarui setelah saya mengubahnya di konsol dan me-restart instans. Apa yang harus saya lakukan?

  • Deskripsi masalah

    Setelah Anda memperbarui nama host di Konsol ECS dan me-restart instans ECS, nama host baru tidak berlaku. Saat Anda menjalankan perintah cloud-init --version, output menunjukkan bahwa versi cloud-init adalah 0.7.6a16 atau lebih lama.

  • Penyebab

    Ketika cloud-init menggunakan modul update_hostname untuk memperbarui nama host, ia menjalankan perintah hostname untuk mendapatkan nama host sistem saat ini dan membaca file /var/lib/cloud/data/previous-hostname untuk mendapatkan nama host dari cache data cloud-init. Kemudian membandingkan kedua nama host tersebut. Jika mereka sama, ia memperbarui nama host. Jika mereka berbeda, ia mengasumsikan bahwa nama host telah diubah secara manual dan tidak memperbaruinya.

    Pada sistem operasi berbasis Red Hat, konten yang dibaca dari /var/lib/cloud/data/previous-hostname diproses dengan baris baru, tetapi output dari perintah hostname tidak. Hal ini menyebabkan ketidakcocokan, dan nama host tidak diperbarui.

  • Solusi

    Anda dapat menggunakan salah satu solusi berikut untuk menyelesaikan masalah ini:

    • Tingkatkan versi cloud-init. Untuk informasi lebih lanjut, lihat Langkah 2: Instal cloud-init.

      • Jika Anda menggunakan CentOS 6 atau sistem operasi sebelumnya, gunakan cloud-init 0.7.6a17.

      • Jika Anda menggunakan CentOS 7, gunakan cloud-init 19.1.21.

      • Jika Anda menggunakan CentOS 8 atau sistem operasi yang lebih baru, kami sarankan Anda menggunakan cloud-init 23.2.2 atau versi yang lebih baru.

    • Secara manual tangani baris baru.

      Secara manual modifikasi file yang rusak cloudinit/distros/rhel.py dalam cloud-init (gunakan perintah find / -name rhel.py untuk menemukan path file). Referensi distros/rhel.py: _read_hostname() missing strip on "hostname" untuk memproses baris baru dalam output perintah hostname. Contoh berikut menunjukkan cara memproses baris baru:

      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: