Hướng Dẫn Lab: Đóng Gói Và Chạy Một Container WebApp Sử Dụng Docker Và GitLab

[dangquangminh]

Hướng Dẫn Lab: Đóng Gói Và Chạy Một Container WebApp Sử Dụng Docker Và GitLab

Giới Thiệu


Lab này hướng dẫn bạn qua quy trình tạo, xây dựng và triển khai một ứng dụng web quản lý kho mạng (Network Inventory) dưới dạng container Docker. Ứng dụng được viết bằng Python với framework Flask, và chúng ta sẽ sử dụng GitLab làm kho lưu trữ mã nguồn và registry cho container. Lab tập trung vào việc tạo Dockerfile, xây dựng image, chạy container, và đẩy image lên GitLab Container Registry.

Mục tiêu của lab là giúp bạn làm quen với Docker, GitLab, và quy trình CI/CD cơ bản cho ứng dụng container hóa. Mục Tiêu


Sau khi hoàn thành lab này, bạn sẽ có thể:

• Tạo và chỉnh sửa Dockerfile để xây dựng image container.
• Xây dựng và chạy container từ Dockerfile.
• Đẩy image lên GitLab Container Registry.
• Chạy ứng dụng từ registry và xác minh hoạt động.

Yêu Cầu

Phần Cứng

• Máy tính với ít nhất 4GB RAM và 20GB dung lượng ổ đĩa trống.
• Kết nối internet ổn định.

Phần Mềm

• Hệ điều hành: Ubuntu 18.04 hoặc tương đương (hoặc sử dụng máy ảo).
• Docker: Phiên bản 18.09.7 hoặc mới hơn (cài đặt qua sudo apt install docker.io).
• Git: Đã cài đặt (cài đặt qua sudo apt install git).
• Visual Studio Code: Đã cài đặt (tải từ trang chính thức hoặc qua snap/flatpak).
• Trình duyệt web: Google Chrome hoặc tương đương.
• Tài khoản GitLab: Sử dụng thông tin đăng nhập được cung cấp (trong lab giả định là từ Job Aids, bạn có thể tạo tài khoản miễn phí trên gitlab.com nếu cần).

Chuẩn Bị

1. Cài đặt Docker và kiểm tra: docker --version.
2. Tạo thư mục lab: mkdir -p ~/labs/lab03.
3. Đảm bảo bạn có quyền truy cập vào GitLab instance (trong lab này là https://git.lab, thay thế bằng URL GitLab của bạn nếu khác).

Các Bước Thực Hiện

Phần 1: Tạo Dockerfile


Bạn sẽ sử dụng Visual Studio Code để chỉnh sửa tệp và terminal tích hợp để chạy lệnh.

1. Mở Visual Studio Code bằng cách nhấp vào biểu tượng trên desktop hoặc chạy code từ terminal.
2. Từ thanh menu: Terminal > New Terminal (hoặc Ctrl+Shift+`).
3. Trong terminal, thay đổi thư mục: cd ~/labs/lab03.
4. Kiểm tra Docker: docker version. Đảm bảo phiên bản là 18.09.7 hoặc tương đương.

Phần 2: Đăng Nhập Vào GitLab Container Registry

1. Đăng nhập: docker login registry.git.lab (thay registry.git.lab bằng registry URL của bạn). Sử dụng username và password từ Job Aids.

Phần 3: Xem Và Sao Chép Mã Nguồn Từ GitLab

1. Mở Chrome, truy cập https://git.lab.
2. Đăng nhập với thông tin từ Job Aids.
3. Chọn dự án cisco-devops/net_inventory.
4. Xem cấu trúc mã nguồn.
5. Trong terminal VS Code: git clone https://git.lab/cisco-devops/net_inventory.
6. Chuyển thư mục: cd net_inventory.
7. Kiểm tra tệp: ls.

Phần 4: Mở Thư Mục Trong VS Code

1. Từ menu: File > Open Folder (Ctrl+K Ctrl+O).
2. Chọn ~/labs/lab03/net_inventory và OK.

Phần 5: Tạo Dockerfile

1. Trong Explorer pane, hover qua thư mục NET_INVENTORY và tạo tệp mới: Dockerfile.
2. Chỉnh sửa nội dung Dockerfile như sau (sao chép và dán vào tệp):

text
FROM registry.git.lab/cisco-devops/containers/python37:latest
LABEL description="Đây là ứng dụng flask quản lý kho mạng"
LABEL maintainer="Cisco <noreply@cisco.com>"
LABEL version="0.1"
ADD ./ /net_inventory
WORKDIR /net_inventory/
RUN apt install -y git vim
RUN pip install -r ./requirements.txt
ENV ENV=DEVELOPMENT
EXPOSE 5000/tcp
ENTRYPOINT python run.py
Lưu tệp (Ctrl+S). Phần 6: Xây Dựng Image Từ Dockerfile

1. Trong terminal: docker build -t dev-net-inv-image ..

Phần 7: Chạy Container Và Xem Ứng Dụng

1. Chạy container: docker run -itd -p 5000:5000 --name dev-net-inv dev-net-inv-image.
2. Kiểm tra: docker container ls.
3. Điền dữ liệu: Chạy script populate_inventory (giả định script có sẵn trong thư mục; nếu không, tạo script đơn giản để điền dữ liệu qua API).
4. Mở Chrome: http://127.0.0.1:5000 để xem front-end.
5. Xem API: http://127.0.0.1:5000/api/docs.
6. Thử POST method trong OpenAPI (không chỉnh JSON lần đầu).

Phần 8: Đẩy Image Lên GitLab Registry

1. Gắn thẻ lại: docker tag dev-net-inv-image registry.git.lab/cisco-devops/containers/net_inventory:latest.
2. Đẩy: docker push registry.git.lab/cisco-devops/containers/net_inventory:latest.
3. Xem trong GitLab: Truy cập dự án cisco-devops/containers, chọn Packages > Container Registry.

Phần 9: Chạy Ứng Dụng Từ Registry

1. Dừng container cũ: docker stop dev-net-inv.
2. Chạy từ registry: docker run -itd -p 5000:5000 --name net-inv-reg registry.git.lab/cisco-devops/containers/net_inventory.
3. Kiểm tra: docker container ls.
4. Xem ứng dụng: http://127.0.0.1:5000.

Lưu Ý

• Nếu gặp lỗi quyền: Sử dụng sudo với Docker commands.
• Dữ liệu trong container là tạm thời; sử dụng volume để lưu trữ lâu dài nếu cần.
• Thay thế git.lab và registry.git.lab bằng URL thực tế của GitLab instance.
• Nếu script populate_inventory không có, bạn có thể tạo một script Python đơn giản để gửi POST request đến API.

Tóm Tắt


Bạn đã hoàn thành việc xây dựng một container từ Dockerfile, chạy ứng dụng cục bộ, và đẩy lên registry. Lab này minh họa quy trình container hóa ứng dụng web, giúp bạn sẵn sàng cho các dự án DevOps lớn hơn. Nếu gặp vấn đề, kiểm tra log Docker bằng docker logs <container_name>.