努力
加油

腾讯云Ubuntu镜像中如何一键部署Docker服务?

在腾讯云 Ubuntu 镜像中部署 Docker,所谓的“一键”通常指的是利用云厂商提供的自动化脚本、Cloud-Init 配置,或者通过简单的 Shell 命令组合来实现。虽然不存在一个真正的魔法按钮(除非你使用容器化应用市场),但我们可以把过程简化为几个核心步骤,确保环境干净、安全且符合最佳实践。

以下是基于腾讯云 Ubuntu 实例的标准操作流程,分为基础手动版(适合理解原理)和自动化/进阶版(适合生产环境)。

一、 前置准备:连接与权限

  1. 登录服务器
    使用 SSH 工具(如 PuTTY、Xshell 或终端)连接到你的腾讯云 Ubuntu 实例。

    ssh root@<你的公网IP>

    注意:Ubuntu 默认用户通常是 ubuntu,如果你使用的是自定义镜像或特定版本,请确认用户名。

  2. 更新系统包
    保持系统最新是减少依赖冲突的关键。

    sudo apt update && sudo apt upgrade -y

二、 标准安装流程(推荐方式)

腾讯云的 Ubuntu 镜像本身并不预装 Docker CE(社区版),因为官方源中的 Docker 版本可能滞后。最稳定、合规的方式是通过 Docker 官方仓库安装。

1. 卸载旧版本(如果存在)

如果之前安装过 docker.io 或其他旧版,建议清理以避免冲突。

sudo apt-get remove docker docker-engine docker.io containerd runc

2. 设置 Docker 官方 GPG 密钥和 APT 源

这一步是为了确保下载的软件来自可信源,防止中间人攻击。

# 安装必要的依赖
sudo apt-get install ca-certificates curl gnupg lsb-release -y

# 添加 Docker 官方 GPG 密钥
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

# 设置存储库
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

3. 安装 Docker Engine

sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin -y

4. 验证安装

sudo docker run hello-world

看到 Hello from Docker! 即表示安装成功。

三、 关键优化:免 sudo 运行 & 开机自启

普通用户每次都要输 sudo docker ... 很麻烦,且容易出错。

1. 创建 docker 用户组并添加当前用户

# 创建 docker 组
sudo groupadd docker

# 将当前用户加入 docker 组
sudo usermod -aG docker $USER

# 激活更改(需要重新登录生效,或执行 newgrp docker)
newgrp docker

2. 设置开机自启并启动服务

sudo systemctl enable docker
sudo systemctl start docker

四、 “伪一键”部署:使用 Cloud-Init 或 UserData

如果你希望在新建实例时自动完成上述所有操作,可以使用腾讯云控制台提供的 “高级选项” -> “自定义数据” 功能,传入一段 Cloud-Init 脚本。

在创建 CVM 实例时,找到“自定义数据”输入框,粘贴以下内容:

#cloud-config
package_update: true
package_upgrade: true

packages:
  - ca-certificates
  - curl
  - gnupg
  - lsb-release

runcmd:
  # 添加 Docker 官方 GPG 密钥
  - mkdir -p /etc/apt/keyrings
  - curl -fsSL https://download.docker.com/linux/ubuntu/gpg | gpg --dearmor -o /etc/apt/keyrings/docker.gpg

  # 设置存储库
  - echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" > /etc/apt/sources.list.d/docker.list

  # 安装 Docker
  - apt-get update
  - apt-get install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

  # 配置权限
  - groupadd docker
  - usermod -aG docker ubuntu
  - systemctl enable docker
  - systemctl start docker

注意:请将 ubuntu 替换为你实际使用的用户名。这种方式实现了真正意义上的“创建即部署”。

五、 常见问题与避坑指南

  1. 网络问题:
    国内访问 download.docker.com 有时较慢。如果遇到下载超时,可以考虑更换为阿里云的 Docker 镜像源(需修改 /etc/apt/sources.list.d/docker.list 中的 URL),但需注意合规性和稳定性风险。强烈建议使用官方源,若速度不可接受,可考虑在本地构建镜像后上传至腾讯云镜像仓库(TCR),再拉取部署。

  2. 内核模块缺失:
    某些精简版 Ubuntu 镜像可能缺少 overlay2 驱动所需的内核模块。如果 Docker 启动失败,检查日志:

    journalctl -u docker.service

    确保安装了 linux-image-extra-virtual 包。

  3. 防火墙与安全组:
    Docker 默认绑定到 127.0.0.1,不会直接暴露端口。如果你需要外部访问容器端口(如 -p 80:80),务必在腾讯云控制台的 安全组 规则中放行相应端口,同时在服务器内部检查 ufw 是否阻止了流量。

  4. 资源限制:
    腾讯云轻量应用服务器(Lighthouse)和低配 CVM 内存较小,Docker 守护进程会占用一定内存。建议至少分配 1GB 以上内存,并配置 Swap 分区以防 OOM(内存溢出)。

六、 总结

对于大多数用户,手动执行第二步的命令序列是最稳妥、最透明的方式。它让你清楚每一步发生了什么,便于后续排查问题。

如果你追求效率,使用 Cloud-Init 脚本 是在新建实例时实现“一键部署”的最佳实践。避免使用第三方非官方的“一键安装包”,这些脚本往往包含未审计的代码,存在安全风险,尤其在云服务器这种高价值资产上,安全性应优先于便利性。