Docker Run To Compose Online - Chuyển Lệnh docker run Sang docker-compose.yml

Tính năng nổi bật

• Tách lệnh như shell: nháy đơn, nháy kép, nối dòng bằng \ (bash), ^ (cmd) và ` (PowerShell), gộp cờ ngắn như -dit, -p80:80
• Nhiều lệnh docker run cùng lúc thành nhiều service; đọc cả docker network create và docker volume create để khai báo sẵn
• Cổng dạng 8080:80, 127.0.0.1:5432:5432, dải cổng và giao thức /udp; luôn đặt trong nháy kép để YAML không hiểu nhầm
• Volume: bind mount, named volume (tự khai báo ở mục volumes cấp cao nhất), volume ẩn danh, --mount dạng đầy đủ, tmpfs, đường dẫn Windows
• Biến môi trường -e, --env-file; dấu $ trong nháy đơn được ghi thành $$ để Compose không hiểu là biến
• --memory, --cpus sang deploy.resources.limits hoặc mem_limit, cpus; --gpus sang reservations.devices
• --health-cmd và các cờ --health-* sang healthcheck; --log-driver, --log-opt sang logging; --restart, --network, --cap-add, --device, --label, --ulimit, --sysctl...
• Bộ sinh YAML riêng, tự đặt nháy kép cho giá trị dễ bị hiểu sai như no, yes, on, 22:22, 0012; báo cáo từng cờ bị bỏ qua hoặc không chuyển được

Vì sao nên chuyển docker run sang Compose, và vì sao làm tay dễ sai

Một lệnh docker run dài hai mươi cờ rất khó đọc lại, khó sửa và dễ mất khi chuyển máy. Đưa vào docker-compose.yml, cấu hình được lưu trong một file, quản lý bằng Git, khởi động lại chỉ với docker compose up -d. Nhưng chuyển tay có nhiều bẫy: restart: no không đặt trong nháy bị YAML hiểu thành false và Compose báo lỗi; cổng 22:22 không đặt nháy bị YAML 1.1 hiểu là số cơ số 60; mật khẩu có dấu $ trong nháy đơn ở shell là ký tự thật nhưng trong Compose lại thành biến rỗng; volume đặt tên phải khai báo thêm ở cấp cao nhất; -d, --rm không có chỗ trong file Compose. Công cụ xử lý các chi tiết đó và nói rõ những gì cần bạn quyết định.

Lợi ích khi sử dụng

• •Lưu cấu hình container thành file, quản lý phiên bản bằng Git thay vì nhớ lệnh dài
• •Tránh lỗi YAML khó thấy như restart: no thành false hay cổng 22:22 thành số
• •Không mất dữ liệu vì quên khai báo named volume khi chuyển sang Compose
• •Biết chính xác cờ nào không chuyển được thay vì phát hiện khi container chạy sai
• •Gộp nhiều container liên quan (web, cơ sở dữ liệu, cache) thành một file khởi động cùng lúc
• •Lệnh có mật khẩu, token không bị gửi đi đâu vì mọi xử lý chạy trong trình duyệt

Cách chuyển lệnh docker run sang docker-compose.yml

1. 1Dán một hoặc nhiều lệnh docker run vào ô bên trái, mỗi lệnh một dòng hoặc nối dòng bằng dấu \. Có thể bấm các nút Mẫu để xem ví dụ Nginx, PostgreSQL, Portainer.
2. 2Chọn cách ghi giới hạn tài nguyên: deploy.resources theo chuẩn Compose, hoặc mem_limit và cpus ngắn gọn.
3. 3Đọc file docker-compose.yml ở ô bên phải, cập nhật ngay khi bạn sửa lệnh.
4. 4Xem Báo cáo chuyển đổi: cờ bị bỏ qua (như -d, --rm) và cờ không chuyển được, cần xử lý tay.
5. 5Bấm Sao chép hoặc Tải docker-compose.yml, đặt vào thư mục dự án rồi chạy docker compose up -d.

Ví dụ: Nginx và Portainer

Lệnh docker run -d --name web -p 8080:80 -v ./html:/usr/share/nginx/html:ro --restart unless-stopped nginx:1.27-alpine được chuyển thành service web với image: nginx:1.27-alpine, container_name: web, restart: unless-stopped, ports là "8080:80" và volumes là ./html:/usr/share/nginx/html:ro. Cờ -d được ghi trong báo cáo là bỏ qua, vì chạy nền là việc của lệnh docker compose up -d. Với lệnh cài Portainer có -v portainer_data:/data, công cụ nhận ra portainer_data là named volume (không có dấu / hay dấu chấm ở đầu) nên thêm mục volumes: portainer_data: ở cấp cao nhất; thiếu dòng này, docker compose sẽ báo lỗi volume chưa được khai báo.

Bảng tương ứng các cờ docker run phổ biến

--name thành container_name và tên service; -p, --publish thành ports; --expose thành expose; -v, --volume và --mount thành volumes; --tmpfs thành tmpfs; -e, --env thành environment; --env-file thành env_file; --restart thành restart; --network thành networks hoặc network_mode (host, none, bridge, container:tên); --network-alias và --ip thành aliases, ipv4_address; -h, --hostname thành hostname; -w, --workdir thành working_dir; -u, --user thành user; --entrypoint thành entrypoint; phần sau tên image thành command dạng danh sách; --cap-add, --cap-drop, --device, --label, --log-driver, --log-opt, --ulimit, --sysctl, --security-opt, --add-host, --dns, --privileged, --read-only, --init, --pid, --ipc, --shm-size, --stop-timeout có khóa tương ứng; -i và -t thành stdin_open và tty; --health-cmd thành healthcheck với test dạng CMD-SHELL.

Giới hạn RAM, CPU: deploy.resources hay mem_limit

Compose Specification đặt giới hạn tài nguyên trong deploy.resources.limits (memory, cpus) và deploy.resources.reservations; Docker Compose v2 áp dụng các giá trị này cả khi không dùng Swarm. Các khóa mem_limit, mem_reservation, cpus ở cấp service cũng hợp lệ và ngắn hơn, nhưng không nên dùng lẫn với deploy.resources cho cùng một giới hạn. Công cụ để bạn chọn một trong hai kiểu. Riêng --gpus luôn được ghi vào deploy.resources.reservations.devices với driver nvidia và capabilities gpu, vì đó là cách Compose khai báo GPU. Các cờ như --memory-swap, --cpu-shares, --cpuset-cpus, --pids-limit được chuyển sang memswap_limit, cpu_shares, cpuset, pids_limit.

Dấu $, nháy và nối dòng: vì sao cần tách lệnh như shell

Công cụ không tách lệnh theo dấu cách đơn giản mà theo quy tắc của bash: nội dung trong nháy đơn giữ nguyên, trong nháy kép cho phép escape \" \$ \\, dấu \ cuối dòng nối dòng. Lệnh chép từ tài liệu Windows dùng ^ (cmd) hoặc ` (PowerShell) để nối dòng cũng được nhận ra, khi đó dấu \ trong đường dẫn C:\data được giữ nguyên. Điểm quan trọng là dấu $: trong shell, -e 'PASS=p@ss$word' là ký tự $ thật; nhưng Compose coi mọi $ trong file là biến môi trường, nên công cụ ghi thành p@ss$$word để giữ đúng giá trị. Còn $VAR không nằm trong nháy đơn được giữ là biến, Compose sẽ lấy từ môi trường hoặc file .env khi chạy. $(pwd) ở đầu đường dẫn volume được đổi thành dấu chấm vì Compose tính đường dẫn tương đối theo thư mục chứa file.

Mạng: external, network_mode và gọi nhau bằng tên

docker run --network ten_mang yêu cầu mạng đã được tạo sẵn, nên công cụ khai báo mạng đó với external: true ở cấp cao nhất để Compose dùng lại đúng mạng cũ. Nếu trong ô nhập có lệnh docker network create ten_mang, công cụ hiểu bạn muốn Compose tự tạo và khai báo mạng bình thường. --network host, none, bridge thành network_mode. --network container:ten thành network_mode: service:ten nếu container đó cũng nằm trong danh sách chuyển đổi. Lưu ý Compose mặc định tạo một mạng riêng cho cả dự án và các service gọi nhau được bằng tên service, nên --link là không cần thiết; nếu giữ network_mode: bridge thì sẽ mất khả năng này.

Cờ bị bỏ qua và cờ không chuyển được

Một số cờ chỉ có ý nghĩa với lệnh docker run nên được bỏ qua kèm giải thích: -d (dùng docker compose up -d), --rm (Compose không tự xóa container khi dừng), -a, --sig-proxy, --detach-keys, --cidfile. Một số cờ không có khóa tương đương trong Compose Specification, ví dụ -P (mở ngẫu nhiên mọi cổng EXPOSE), --blkio-weight-device, --device-read-bps, --label-file, các tùy chọn lạ của --mount; chúng được liệt kê ở mục Không chuyển được để bạn tự quyết định. Cờ công cụ không nhận ra được coi là cờ không nhận giá trị và có cảnh báo kiểm tra lại tên image, vì nếu cờ đó thực ra có giá trị thì giá trị sẽ bị hiểu nhầm là image.

Giới hạn của công cụ

Công cụ không chạy lệnh, không kết nối Docker và không kiểm tra image có tồn tại. Biến và lệnh con của shell như $HOME, $(date) không được thực thi mà giữ nguyên dạng biến. Mỗi dòng không nối được xem là một lệnh riêng; lệnh không phải docker run, docker create, docker network create hay docker volume create bị bỏ qua. Tên service được đặt từ --name, nếu không có thì từ tên image, trùng thì thêm số. File sinh ra theo Compose Specification, không có khóa version đã lỗi thời; một số khóa mới như annotations cần Docker Compose bản gần đây. Hãy chạy docker compose config để kiểm tra lại trên máy của bạn trước khi dùng cho môi trường thật.

Câu hỏi thường gặp (FAQ)

Từ khóa liên quan

• docker run to compose online
• docker run to docker compose
• chuyển docker run sang docker compose
• convert docker run to docker-compose
• docker run sang docker-compose.yml
• tạo docker-compose từ lệnh docker run
• docker compose converter
• docker run to compose converter
• docker run command to yaml
• docker compose ports volumes environment
• docker compose named volume
• docker compose restart no
• docker compose deploy resources limits
• docker compose healthcheck
• docker compose network external
• docker compose không cần version
• docker compose dollar sign
• portainer docker compose
• postgres docker compose
• docker compose cho người mới