Customized Linux 配置说明
发布时间：2017-07-24 17:44

1. 在镜像的第一个分区的根目录下创建目录 aliyun_custom_image。
2. 使用该镜像所创建的实例在启动时，阿里云会在 aliyun_custom_image 目录的 os.conf 文件中写入实例相关配置信息。如果不存在这个文件，则会自动创建。
3. 镜像中需要有一个预定义的启动脚本，该脚本用来解析 os.conf 文件的各项配置，并进行相关配置，详见 配置解析脚本 − 注意事项 和 脚本示例。

• 定制版镜像的第一个分区必须可以被写入。
• 镜像的虚拟文件大小必须大于 5 GB。
• 定制版镜像的第一个分区类型支持 FAT32/EXT2/EXT3/EXT4/UFS。

• 不得存在可被远程利用的高危漏洞。
• 使用控制台的 管理终端 功能登录时如果存在初始默认密码，则必须在首次登录时修改，修改之前不允许进入系统做任何操作。
• SSH 不允许有初始默认密码，初始密码必须随机生成（通过阿里云 ECS 控制系统下发）。

1. hostname=iZ23r29djmjZ
2. password=cXdlcjEyMzQK
3. eth0_ip_addr=10.171.254.123
4. eth0_mac_addr=00:8c:fa:5e:14:23
5. eth0_netmask=255.255.255.0
6. eth0_gateway=10.171.254.1
7. eth0_route="10.0.0.0/8 10.171.254.1;172.16.0.0/12 10.171.254.1"
8. eth1_ip_addr=42.120.74.105
9. eth1_mac_addr=00:8c:fa:5e:14:24
10. eth1_netmask=255.255.255.0
11. eth1_gateway=42.120.74.1
12. eth1_route="0.0.0.0/0 42.120.74.1"
13. dns_nameserver="7.7.7.7 8.8.8.8"

1. hostname=iZ23r29djmjZ
2. password=cXdlcjEyMzQK
3. eth0_ip_addr=10.171.254.123
4. eth0_mac_addr=00:8c:fa:5e:14:23
5. eth0_netmask=255.255.255.0
6. eth0_gateway=10.171.254.1
7. eth0_route="0.0.0.0/0 10.171.254.1"
8. dns_nameserver="7.7.7.7 8.8.8.8"

• 各配置项设值规则：如 os.conf 配置文件示例 的配置项所述，VPC 与经典网络实例的配置项数量和部分配置项的取值规则均有所不同。
• 开机启动：该脚本需要设置成开机自动运行。
• 配置文件读取路径：镜像在创建 I/O 优化实例或非 I/O 优化实例时，为第一个分区所分配的设备名默认不一样；所以在脚本中最好可以以 uuid 或 label 来识别第一个分区的设备。
• 用户密码为 Base64 编码的字符串，所以在设置密码时需要进行相关处理。
• 对于 VPC 及经典网络的判断：需要在脚本中判断该实例是经典网络还是 VPC 网络。目前最简单的方法是判断配置项中是否存在 eth1_route 或其他 eth1 相关的配置项。
• VPC 及经典网络的配置项不同之处：

• 对于 VPC 实例，所写入的 os.conf 中会在 eth0_route 参数中配置默认外网路由；
• 对于经典网络实例，会在 eth1_route 参数中配置默认路由，内网路由配置在 eth0_route 中。

• 配置优化：os.conf 中的配置在实例的整个生命周期中执行一次即可，所以在脚本执行成功后最好删掉 os.conf 配置文件，同时脚本如果没有读取到 os.conf 配置，则不执行文件中的配置。
• 自定义镜像的处理：根据 Customized Linux 实例所创建的自定义镜像，在镜像中也会包含这个开机启动脚本。使用该自定义镜像创建实例时，阿里云会在实例第一次启动时写入 os.conf 配置，脚本在检测到该配置时即可执行相关配置。
• 修改相关配置时的处理：当实例的配置信息通过阿里云的控制台或 API 发生变更时，阿里云会把相关信息写入到 os.conf 中，脚本将被再次执行从而下发这些更改。

• 该脚本仅供参考，您需要根据实际的操作系统类型进行调整从而得到具体的脚本。
• 在使用脚本前，请先在镜像中调试脚本，并保证调试通过。
• 该脚本必须配置为开机自动执行，比如将这个脚本放到 /etc/init.d/ 目录下。

1. #!/bin/bash
2. ### BEGIN INIT INFO
3. # Provides: os-conf
4. # Required-Start: $local_fs $network $named $remote_fs
5. # Required-Stop:
6. # Should-Stop:
7. # Default-Start: 2 3 4 5
8. # Default-Stop: 0 1 6
9. # Short-Description: The initial os-conf job, config the system.
10. ### END INIT INFO
11. first_partition_dir='/boot/'
12. os_conf_dir=${first_partition_dir}/aliyun_custom_image
13. os_conf_file=${os_conf_dir}/os.conf
14. load_os_conf(){
15. if[[-f $os_conf_file ]];then
16. . $os_conf_file
17. return0
18. else
19. return1
20. fi
21. }
22. cleanup(){
23. # ensure $os_conf_file is deleted, to avoid repeating config system
24. rm $os_conf_file >&/dev/null
25. # ensure $os_conf_dir is exitst
26. mkdir -p $os_conf_dir
27. }
28. config_password(){
29. if[[-n $password ]];then
30. password=$(echo $password | base64 -d)
31. if[[ $?==0&&-n $password ]];then
32. echo "root:$password"| chpasswd
33. fi
34. fi
35. }
36. config_hostname(){
37. if[[-n $hostname ]];then
38. sed -i "s/^HOSTNAME=.*/HOSTNAME=$hostname/"/etc/sysconfig/network
39. hostname $hostname
40. fi
41. }
42. config_dns(){
43. if[[-n $dns_nameserver ]];then
44. dns_conf=/etc/resolv.conf
45. sed -i '/^nameserver.*/d' $dns_conf
46. for i in $dns_nameserver;do
47. echo "nameserver $i">> $dns_conf
48. done
49. fi
50. }
51. is_classic_network(){
52. # vpc: eth0
53. # classic: eth0 eth1
54. grep -q 'eth1' $os_conf_file
55. }
56. config_network(){
57. /etc/init.d/network stop
58. config_interface eth0 ${eth0_ip_addr} ${eth0_netmask} ${eth0_mac_addr}
59. config_route eth0 ${eth0_route}
60. if is_classic_network ;then
61. config_interface eth1 ${eth1_ip_addr} ${eth1_netmask} ${eth1_mac_addr}
62. config_route eth1 ${eth1_route}
63. fi
64. /etc/init.d/network start
65. }
66. config_interface(){
67. localinterface=$1
68. local ip=$2
69. local netmask=$3
70. local mac=$4
71. inteface_cfg="/etc/sysconfig/network-scripts/ifcfg-${interface}"
72. cat << EOF > $inteface_cfg
73. DEVICE=$interface
74. IPADDR=$ip
75. NETMASK=$netmask
76. HWADDR=$mac
77. ONBOOT=yes
78. BOOTPROTO=static
79. EOF
80. }
81. config_default_gateway(){
82. local gateway=$1
83. sed -i "s/^GATEWAY=.*/GATEWAY=$gateway/"/etc/sysconfig/network
84. }
85. config_route(){
86. localinterface=$1
87. local route=$2
88. route_conf=/etc/sysconfig/network-scripts/route-${interface}
89. > $route_conf
90. echo $route | sed 's/;/\n/'| \
91. while read line;do
92. dst=$(echo $line | awk '{print $1}')
93. gw=$(echo $line | awk '{print $2}')
94. if! grep -q "$dst" $route_conf 2>/dev/null;then
95. echo "$dst via $gw dev $interface">> $route_conf
96. fi
97. if[["$dst"=="0.0.0.0/0"]];then
98. config_default_gateway $gw
99. fi
100. done
101. }
102. ################## sysvinit service portal ####################
103. start(){
104. if load_os_conf ;then
105. config_password
106. config_network
107. config_hostname
108. config_dns
109. cleanup
110. return0
111. else
112. echo "not load $os_conf_file"
113. return0
114. fi
115. }
116. RETVAL=0
117. case"$1"in
118. start)
119. start
120. RETVAL=$?
121. ;;
122. *)
123. echo "Usage: $0 {start}"
124. RETVAL=3
125. ;;
126. esac
127. exit $RETVAL