Hướng dẫn tự động cài đặt và cấu hình Docker trên Ubuntu bằng Ansible

Giới thiệu

Docker là nền tảng đóng gói ứng dụng (containerization) phổ biến nhất hiện nay, trong khi Ansible là công cụ quản lý cấu hình và tự động hóa mạnh mẽ. Việc kết hợp Ansible để tự động cài đặt Docker giúp bạn tiết kiệm thời gian, giảm thiểu lỗi thủ công và dễ dàng chuẩn hóa hạ tầng trên nhiều máy chủ Ubuntu cùng lúc.

Trong bài viết này, Bitech sẽ hướng dẫn bạn xây dựng một Ansible Playbook hoàn chỉnh để cài đặt Docker Engine và Docker CLI trên hệ điều hành Ubuntu.

Yêu cầu chuẩn bị

Trước khi bắt đầu, bạn cần chuẩn bị:

1. Ansible Control Node: Máy tính hoặc máy chủ đã cài đặt Ansible.
2. Managed Node: Một hoặc nhiều máy chủ Ubuntu mục tiêu, có thể truy cập qua SSH từ Control Node với quyền sudo.
3. File inventory chứa thông tin danh sách máy chủ Ubuntu cần triển khai.

Bước 1: Tạo tệp Ansible Playbook

Trên Control Node, bạn tạo tệp tin Playbook có tên setup-docker.yml bằng câu lệnh:

nano setup-docker.yml

Bước 2: Định nghĩa nội dung Playbook

Dưới đây là nội dung Playbook chuẩn hóa bao gồm các bước cập nhật hệ thống, thêm GPG key chính thức của Docker, thêm kho lưu trữ (repository) và tiến hành cài đặt Docker:

---
- name: Cài đặt và cấu hình Docker trên Ubuntu
  hosts: all
  become: true
  tasks:
    - name: Cập nhật APT cache và cài đặt các gói phụ thuộc
      apt:
        name:
          - apt-transport-https
          - ca-certificates
          - curl
          - software-properties-common
          - gnupg
        state: present
        update_cache: yes

    - name: Thêm khóa GPG chính thức của Docker
      apt_key:
        url: https://download.docker.com/linux/ubuntu/gpg
        state: present

    - name: Thêm kho lưu trữ Docker vào APT sources
      apt_repository:
        repo: deb [arch=amd64] https://download.docker.com/linux/ubuntu {{ ansible_distribution_release }} stable
        state: present

    - name: Cài đặt Docker Engine và Docker CLI
      apt:
        name:
          - docker-ce
          - docker-ce-cli
          - containerd.io
        state: latest
        update_cache: yes

    - name: Đảm bảo dịch vụ Docker đang chạy và khởi động cùng hệ thống
      systemd:
        name: docker
        state: started
        enabled: yes

    - name: Thêm người dùng hiện tại vào nhóm docker
      user:
        name: "{{ ansible_user }}"
        groups: docker
        append: yes

Bước 3: Kiểm tra và thực thi Playbook

Trước khi chạy Playbook chính thức, bạn có thể kiểm tra cú pháp tệp YAML:

ansible-playbook --syntax-check setup-docker.yml

Nếu không xuất hiện lỗi, hãy tiến hành thực thi Playbook lên các máy chủ trong file inventory:

ansible-playbook -i inventory setup-docker.yml

Quá trình cài đặt sẽ diễn ra tự động. Sau khi hoàn tất, Ansible sẽ hiển thị bảng tóm tắt trạng thái (PLAY RECAP).

Bước 4: Kiểm tra kết quả cài đặt

Đăng nhập vào máy chủ Ubuntu mục tiêu qua SSH và kiểm tra phiên bản Docker vừa được cài đặt bằng lệnh:

docker --version

Bạn cũng có thể chạy thử container kiểm tra cơ bản:

docker run hello-world

Kết luận

Chỉ với một tệp Ansible Playbook đơn giản, bạn đã tự động hóa hoàn toàn quy trình cài đặt Docker trên hạ tầng Ubuntu của mình. Cách làm này không chỉ đảm bảo tính đồng nhất giữa các môi trường mà còn giúp quy mô hạ tầng của bạn phát triển dễ dàng hơn bao giờ hết.

Ngày phát hành: 12/05/2026
Nguồn: www.digitalocean.com