这两天升级几个Debian 8 （jessie）的droplet，屡次失败，后来参考了一篇blog（请点击此处了解），并多次尝试后才最终成功。回过头来看看，其实整个过程很简单，只是被一个点卡住，就来回折腾。本文简要记录一下操作顺序和操作要点，以备日后查看。

修改 /etc/apt/sources.list 文件

这个是通用步骤了，修改成 Debian 9 (stretch) 的源即可。

deb http://deb.debian.org/debian stretch main contrib non-free
deb http://deb.debian.org/debian stretch-updates main contrib non-free
deb http://deb.debian.org/debian stretch-proposed-updates main contrib non-free
deb http://deb.debian.org/debian stretch-backports main contrib non-free
deb http://deb.debian.org/debian-security stretch/updates main contrib non-free

deb-src http://deb.debian.org/debian stretch main contrib non-free
deb-src http://deb.debian.org/debian stretch-updates main contrib non-free
deb-src http://deb.debian.org/debian stretch-proposed-updates main contrib non-free
deb-src http://deb.debian.org/debian stretch-backports main contrib non-free
deb-src http://deb.debian.org/debian-security stretch/updates main contrib non-free

这里也可以用 DO 自己的镜像站点的源（http://mirrors.digitalocean.com/）。考虑到我们的droplet都部署在欧洲和美国，因此速度上没太大差别，还是直接取官网的源好了。

备份 /etc/cloud 目录

使用以下命令直接备份即可。这步骤非常重要，实际上是整个升级的关键点！后面操作中，必须要还原这个目录！

cp -r /etc/cloud /etc/cloud-bak

停止所有相关的服务

这也是通用步骤，没什么细讲。有什么服务就停什么服务好了。

systemctl stop apache2
systemctl stop mysql
systemctl stop fail2ban
systemctl stop dovecot

更新并升级

需要注意的是，一般情况下，升级提示是否保留原有配置时，一般都保留原有配置，这个也是默认选项。但是对于fail2ban的jail.conf文件，建议采用系统新的文件，后面手工再改即可。

我在这个更新过程中，没有提示是否保留/etc/cloud的配置，因此后面需要手工还原备份的/etc/cloud目录，如果是系统提示了，务必要保留原有的/etc/cloud配置。

apt update
apt upgrade
apt dist-upgrade

还原 /etc/cloud 目录

完成各项更新后，先不要重启系统，务必先还原 /etc/cloud 目录。这步相当关键！如果没有还原，将采用系统新的/etc/cloud 配置，导致cloud-init 过程失败，系统无法启动！

rm /etc/cloud
cp -r /etc/cloud-bak /etc/cloud

最后，就是重启系统，完成整个升级。

关于 /etc/cloud 目录，只在 DO 的系统中有这个目录，在 Linode 等其他VPS系统没有发现。感觉是 DO 处理上一个不太完善的地方，这个目录似乎没有必要暴露给客机系统，主机系统配置即可。

和 DO 的技术支持人员简单交流了这个问题，平台相关的元数据（metadata）是保留在 /var/lib/cloud 目录下，似乎 /etc/cloud 只是上游云系统的初始化配置（根据 /var/log/cloud-init.log, 系统初始化时需要从这个目录下读取 cloud.cfg 等配置）。