Elastic Compute Service:Instal cloud-init

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

Langkah 1: Periksa apakah Anda perlu menginstal atau meng-upgrade cloud-init

1. Login ke server sumber.

2. Jalankan perintah berikut untuk memeriksa 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 yang dikembalikan atau versinya lebih awal dari 0.7.9: Anda harus Langkah 2: Instal cloud-init.

     Penting

     Versi 0.7.9 merupakan edisi komunitas awal cloud-init dan tidak dapat digunakan untuk menginisialisasi instans ECS. Anda harus melakukan upgrade 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: Kami merekomendasikan agar Anda melakukan upgrade ke Alibaba Cloud cloud-init 23.2.2. Dibandingkan dengan Alibaba Cloud cloud-init 19.1.21, Alibaba Cloud cloud-init 23.2.2 menyediakan peningkatan dan fitur berikut:

     • Jika versi cloud-init sebuah instans adalah 23.2.2, instans tersebut mendukung akses ke metadata dalam mode Penguatan Keamanan. Untuk informasi lebih lanjut tentang instance metadata, lihat Instance metadata.

     • Peningkatan fitur lainnya, peningkatan performa, perbaikan bug, dan kontribusi komunitas. Untuk informasi lebih lanjut, lihat file ChangeLog.

   • Kasus lainnya: Anda tidak perlu menginstal cloud-init. Anda dapat langsung melanjutkan ke Langkah selanjutnya.

3. Untuk mencegah kehilangan data akibat operasi tidak disengaja selama instalasi cloud-init, kami merekomendasikan agar Anda membuat backup data server sumber terlebih dahulu, misalnya dengan membuat Snapshot.

Langkah 2: Instal cloud-init

• Alibaba Cloud cloud-init 23.2.2: direkomendasikan. Versi ini bergantung pada Python 3.6 atau lebih baru dan menggunakan sumber data Aliyun.

• Alibaba Cloud cloud-init 19.1.21: Versi ini bergantung pada Python 3.6 atau lebih baru dan menggunakan sumber data Aliyun.

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

  Penting

  Komunitas Python telah menghentikan dukungan teknis untuk Python 2.7. Kami merekomendasikan agar Anda menggunakan versi cloud-init yang lebih baru bila memungkinkan untuk menghindari potensi masalah pada library dependensi.

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

Edisi komunitas cloud-init adalah versi resmi proyek cloud-init, sedangkan Alibaba Cloud cloud-init dioptimalkan untuk platform Alibaba Cloud dan memberikan dukungan yang lebih baik untuk layanan platform Alibaba Cloud. Oleh karena itu, kami merekomendasikan agar Anda menggunakan Alibaba Cloud cloud-init. Pilih edisi cloud-init yang akan diinstal berdasarkan kebutuhan aktual Anda.

# Periksa dan instal python3-pip
if ! python3 -c 'import setuptools' >& /dev/null; then
  yum -y install python3-pip
fi
# Backup versi cloud-init sebelumnya
test -d /etc/cloud && mv /etc/cloud /etc/cloud-old
# Unduh dan ekstrak 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 cloud-init sebelumnya
test -d /etc/cloud && mv /etc/cloud /etc/cloud-old
# Unduh dan ekstrak 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 cloud-init sebelumnya
test -d /etc/cloud && mv /etc/cloud /etc/cloud-old
# Unduh dan ekstrak 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 cloud-init sebelumnya
test -d /etc/cloud && mv /etc/cloud /etc/cloud-old
# Unduh dan ekstrak 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 cloud-init sebelumnya
test -d /etc/cloud && mv /etc/cloud /etc/cloud-old
# Unduh dan ekstrak 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 cloud-init sebelumnya
test -d /etc/cloud && mv /etc/cloud /etc/cloud-old
# Unduh dan ekstrak 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 library dependensi hilang saat menginstal cloud-init menggunakan Python 3?

  Image yang berbeda mungkin kekurangan library yang berbeda. Anda dapat menginstal library yang hilang menggunakan pip, lalu menginstal cloud-init lagi.

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

  Jika package manager default sistem (seperti yum) dan manager pip telah menginstal versi library dependensi yang berbeda, konflik versi library dapat terjadi dan menyebabkan cloud-init berjalan tidak normal. Kami merekomendasikan agar Anda mengunduh library dependensi yang diperlukan berdasarkan pesan error.

  Pesan error	Penyebab	Perintah troubleshooting
  no setuptools module in python	Modul python setuptools hilang	Ambil Python 3.6 sebagai contoh: 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 )	Library dependensi oauthlib hilang	pip3 install oauthlib
  Pesan error tidak menentukan library dependensi yang hilang	Pesan error tidak dipetakan	Berdasarkan library yang tercantum dalam file requirements.txt cloud-init, jalankan perintah berikut untuk menginstal semua library dependensi: pip3 install -r requirements.txt

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

  Jika Anda menginstal versi baru Python 3 (seperti Python 3.9) pada instans dan mengatur versi baru tersebut sebagai versi default (yaitu, Anda telah membuat tautan simbolik untuk versi Python 3 baru tersebut, misalnya, ln -s /usr/bin/python3.9 /usr/bin/python3), cloud-init yang terinstal berjalan tidak normal. Sebagai contoh, menjalankan cloud-init --version menghasilkan error berikut:

  $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 mengatasi masalah ini:

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

  • Metode 2: Modifikasi file executable cloud-init untuk mengubah path interpreter Python ke versi Python 3 sebelumnya. Ambil Python 3.6 sebagai contoh. Lakukan operasi berikut untuk memodifikasi interpreter dalam file executable cloud-init:

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

       vim   /usr/local/bin/cloud-init

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

       Setelah modifikasi, baris #! menjadi sebagai berikut:

       #!/usr/bin/python3.6

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

• Apa yang harus saya lakukan jika user data yang ditentukan dalam instance metadata saat pembuatan instans tidak dijalankan atau gagal dijalankan setelah cloud-init diinstal?

  1. Jalankan perintah berikut di dalam instans untuk memeriksa apakah user-data ada dalam instance metadata.

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

     Deskripsi hasil pemeriksaan:

     • Jika user-data diatur, informasi user-data yang sesuai akan dikembalikan. Lanjutkan ke langkah berikutnya untuk troubleshooting.

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

  2. Gunakan metode berikut untuk troubleshooting mengapa user-data tidak dijalankan atau gagal dijalankan.

     • Periksa apakah format user-data benar.

       User-data dijalankan oleh cloud-init. Anda harus memastikan bahwa format datanya benar. Sebagai contoh, baris pertama user-data harus dimulai dengan #!. Untuk informasi lebih lanjut, lihat Sesuaikan konfigurasi inisialisasi instans.

     • Periksa hasil eksekusi user-data dalam file log cloud-init /var/log/cloud-init.log dan troubleshooting berdasarkan pesan error.

       Contoh berikut menunjukkan 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 error standar dari proses eksekusi user-data.

       Dalam systemd, tool inisialisasi sistem Linux, user-data dijalankan oleh layanan sistem cloud-final.service. Anda dapat menjalankan perintah berikut untuk melihat output standar dan output error standar dari proses eksekusi user-data dan troubleshooting berdasarkan output tersebut.

       journalctl -u cloud-final.service

     • Jika metode di atas tidak dapat mengidentifikasi penyebab user-data tidak dijalankan atau gagal dijalankan, kami merekomendasikan agar Anda menyalin konten user-data ke host on-premises untuk debugging guna memeriksa apakah dapat dijalankan dengan sukses.

• Apa yang harus saya lakukan jika konfigurasi inisialisasi sistem dan skrip instance user data tidak berjalan sesuai harapan setelah cloud-init diinstal?

  1. Jalankan perintah berikut untuk memeriksa apakah keempat layanan cloud-init diatur untuk start saat startup sistem.

     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 error atau disabled dikembalikan, cloud-init tidak diatur untuk start saat startup sistem.

  2. Jalankan perintah berikut untuk mengatur cloud-init agar start saat startup sistem.

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

• Apa yang harus saya lakukan jika partisi root tidak diperluas secara otomatis di dalam instans setelah saya memperluas sistem disk saat pembuatan instans?

  Ekspansi partisi otomatis untuk instans Linux didukung oleh cloud-init. Pastikan tool growpart telah terinstal di sistem dan file cloud.cfg dikonfigurasi dengan benar.

  1. Jalankan perintah berikut untuk memeriksa apakah tool growpart telah terinstal di sistem.

     which growpart

  2. (Diperlukan secara kondisional) Jika tool tersebut belum terinstal, jalankan perintah berikut untuk menginstal tool growpart.

     • 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 konten berikut ada dalam file /etc/cloud/cloud.cfg.

     cat /etc/cloud/cloud.cfg

     Pastikan frekuensi growpart dan resizefs adalah once-per-instance:

     # Modul yang berjalan pada tahap 'init'
     cloud_init_modules:
      - migrator
      - source-address
      - pip-source
      - seed_random
      - bootcmd
      - write-files
      - [ growpart, once-per-instance ]
      - [ resizefs, once-per-instance ]
      - set_hostname
      - update_hostname
      - update_etc_hosts
      - rsyslog
      - users-groups
      - ssh

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

• Apa yang harus saya lakukan jika hostname baru tidak berlaku setelah saya memperbarui hostname di konsol dan me-restart instans ECS yang versi cloud-init-nya 0.7.6a16 atau lebih awal?

  • Deskripsi masalah

    Setelah Anda memperbarui hostname di Konsol ECS dan me-restart instans ECS, hostname baru tidak diatur. Saat Anda menjalankan perintah cloud-init --version, versi cloud-init adalah 0.7.6a16 atau lebih awal.

  • Penyebab

    Saat cloud-init memperbarui hostname melalui modul update_hostname, cloud-init menjalankan perintah hostname untuk mendapatkan hostname sistem saat ini, membaca file /var/lib/cloud/data/previous-hostname untuk mendapatkan hostname dalam cache data cloud-init, lalu memeriksa apakah keduanya konsisten. Jika konsisten, hostname diperbarui. Jika tidak konsisten, cloud-init mengasumsikan bahwa hostname telah dimodifikasi secara manual dan tidak memperbarui hostname.

    Pada sistem operasi seri Red Hat, line break dalam file /var/lib/cloud/data/previous-hostname diproses saat file dibaca, tetapi output perintah hostname tidak diproses untuk line break. Akibatnya, kedua hasil tidak konsisten dan hostname tidak diperbarui.

  • Solusi

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

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

      • Jika Anda menggunakan CentOS 6 atau lebih awal, gunakan cloud-init 0.7.6a18.

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

      • Jika Anda menggunakan CentOS 8 atau lebih baru, kami merekomendasikan agar Anda menggunakan cloud-init 23.2.2 atau lebih baru.

    • Proses line break secara manual.

      Modifikasi secara manual file cloud-init yang rusak cloudinit/distros/rhel.py (dapatkan path file dengan menjalankan perintah find / -name rhel.py). Rujuk distros/rhel.py: _read_hostname() missing strip on "hostname" untuk memproses line break dalam output perintah hostname. Contoh berikut menunjukkan cara memproses line break:

      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: