8.3 cloud-init 介绍

cloud-init 是一个系统配置工具，当系统起来时， cloud-init 会从固定分区读取数据，然后执行定制化 操作。

cloud-init 有四个执行阶段：

  • local: cloud-init-local.service
  • init: cloud-init.service
  • config: cloud-config.service
  • final: cloud-final.service

配置

cloud-init 各阶段完成哪些工作可以在 /etc/cloud/cloud.cfg 中查看

  1. local 阶段

    作为 cloud-init 的初始阶段，此时主要完成网口的配置

    /usr/bin/cloud-init init --local

  2. init 阶段

  3. config 阶段

  4. final 阶段

cloud-init 脚本生成

社区提供了 write-mime-multipart 工具来生成 cloud-init 脚本。 使用方法如下：

$ cat my-boothook.txt
#!/bin/sh
echo "Hello World!"
echo "This will run as soon as possible in the boot sequence"

$ cat my-user-script.txt
#!/usr/bin/perl
print "This is a user script (rc.local)\n"

$ cat my-include.txt
# these urls will be read pulled in if they were part of user-data
# comments are allowed.  The format is one url per line
http://www.ubuntu.com/robots.txt
http://www.w3schools.com/html/lastpage.htm

$ cat my-upstart-job.txt
description "a test upstart job"
start on stopped rc RUNLEVEL=[2345]
console output
task
script
echo "====BEGIN======="
echo "HELLO From an Upstart Job"
echo "=====END========"
end script

$ cat my-cloudconfig.txt
#cloud-config
ssh_import_id: [smoser]
apt_sources:
 - source: "ppa:smoser/ppa"

$ write-mime-multipart --output=combined-userdata.txt \
    my-boothook.txt:text/cloud-boothook \
    my-include.txt:text/x-include-url \
    my-upstart-job.txt:text/upstart-job \
    my-user-script.txt:text/x-shellscript \
    my-cloudconfig.txt

User Data 输入格式

  1. Gzip Compressed Content

  2. Mime Multi Part archive

  3. User-Data Script

    以 #! 或 Content-Type: text/x-shellscript 开头。

    存放用户脚本，可以是 python, shell, perl 等。user data 里的脚本执行比较晚，类似 rc.local， 而且只在第一次启动时 执行。

  4. Include File

    以 #include 或 Content-Type: text/x-include-url 开头。

    includ file 的内容是一串 url, 每行一个，cloud-init 启动时会 读取 url 链接的内容。

  5. Cloud Config Data

    以 #cloud-config 或 Content-Type: text/cloud-config 开头， 内容按规定格式编写。

  6. Upstart Job

    以 #upstart-job 或 Content-Type: text/upstart-job 开头，

    文件内容会存放在 /etc/init ，以供其它 job 使用。

  7. Cloud Boothook

    以 #cloud-boothook 或 Content-Type: text/cloud-boothook 开头。

    boothook 数据会保存到 /var/lib/cloud ，然后立刻执行。boothook 每次上电都会执行，没有机制指定只运行一次。

  8. Part Handler

测试

如果要测试 cloud-init 脚本，每次通过 nova boot 来操作有点麻烦。 这里提供两种便捷的方式：

修改 xml 文件

  1. 准备好你的 configdrive 文件，这里假设是 disk.cfg;

  2. 虚机 xml 文件中添加一个 disk 标签，内容如下:

    <disk type="file" device="cdrom">
    <driver name="qemu" type="raw" cache="none"/>
    <source file="/root/disk.cfg"/>
    <target bus="ide" dev="hdd"/>
</disk>

  3. 通过 virsh 启动虚机

当我们需要修改 disk.cfg 内容时，进行如下操作：

$ sudo mount /root/disk.cfg /mnt
$ mkdir configdrive
$ cp -r /mnt/* configdrive
$ genisoimage -o disk.cfg -ldots -allow-lowercase -allow-multidot -l -quiet \
  -J -r -V 'config-2' configdrive

使用 config-2 分区

  1. 启动虚机；

  2. 创建一个 64M 的分区;

  3. 把 configdrive 文件 dd 到该分区，eg:

    $ sudo dd if=/root/disk.cfg of=/dev/sda4

  4. 重启系统

以上两种方式如果要多次运行，需要在下次运行前把 cloud-init 记录删除:

$ sudo rm -rf /var/lib/cloud/*