Phần 8 — Environments, Deployments và Review Apps

Series GitLab CI/CD Toàn Tập — 9 phần:

1. Phần 1 — Tổng quan: GitLab CI/CD, kiến trúc và các khái niệm

2. Phần 2 — .gitlab-ci.yml đầu tiên và Variables (predefined, UI, masked)

3. Phần 3 — Cache vs Artifacts: chiến lược và Reports

4. Phần 4 — Rules và Merge Request Pipelines

5. Phần 5 — GitLab Runner self-hosted: cài đặt và executors (Shell/Docker)

6. Phần 6 — Kubernetes executor: scale runner trên K8s

7. Phần 7 — include, extends, anchors — pipeline modular

8. Phần 8 — Environments, Deployments và Review Apps ← bạn đang đọc

9. Phần 9 — Pipeline thực tế Next.js → Docker → K8s + best practices + debug

Mở đầu

GitLab phân biệt rõ build job và deployment job qua khai báo environment:. Việc khai báo này không chỉ trang trí — GitLab dùng nó để theo dõi lịch sử deploy, cung cấp nút rollback, và đặc biệt là kích hoạt Review Apps — tính năng signature cho phép mỗi merge request tự deploy preview lên Kubernetes/Docker, QA bấm link là xem được ngay.

1. Environments & Deployments

GitLab phân biệt rõ build job và deployment job. Khai báo environment: để GitLab theo dõi:

deploy-staging:
  stage: deploy
  script:
    - ./deploy.sh staging
  environment:
    name: staging
    url: https://staging.example.com
    deployment_tier: staging
  rules:
    - if: $CI_COMMIT_BRANCH == "main"

deploy-prod:
  stage: deploy
  script:
    - ./deploy.sh production
  environment:
    name: production
    url: https://example.com
    deployment_tier: production
  rules:
    - if: $CI_COMMIT_TAG
      when: manual
  resource_group: production    # Mutex — chặn 2 deploy đồng thời

Vào Operate → Environments, bạn sẽ thấy lịch sử deploy của từng environment, link tới commit/job, nút Rollback để re-trigger deploy của một commit cũ.

resource_group rất quan trọng cho production — nó tạo mutex, đảm bảo chỉ 1 deploy chạy mỗi lần. Hai MR merge sát nhau sẽ deploy tuần tự thay vì đè nhau.

2. Review Apps — Mỗi MR một môi trường tạm

Tính năng signature của GitLab. Mỗi merge request tự deploy bản preview lên Kubernetes/Docker, QA bấm link xem trực tiếp.

deploy-review:
  stage: deploy
  image: alpine/k8s:1.30
  script:
    - kubectl apply -f k8s/review.yml -n review-$CI_MERGE_REQUEST_IID
  environment:
    name: review/$CI_MERGE_REQUEST_IID
    url: https://mr-$CI_MERGE_REQUEST_IID.review.example.com
    on_stop: stop-review     # Job dọn dẹp khi MR close
    auto_stop_in: 7 days     # Tự dọn sau 7 ngày inactive
  rules:
    - if: $CI_PIPELINE_SOURCE == "merge_request_event"

stop-review:
  stage: deploy
  image: alpine/k8s:1.30
  script:
    - kubectl delete namespace review-$CI_MERGE_REQUEST_IID
  environment:
    name: review/$CI_MERGE_REQUEST_IID
    action: stop
  rules:
    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
      when: manual
  allow_failure: true

GitLab tự hiện link trong MR ngay khi job deploy xong. Khi MR đóng, GitLab tự gọi stop-review để dọn dẹp tài nguyên.

Tóm tắt

Trong phần này bạn đã nắm:

• environment.name + url để GitLab theo dõi; vào Operate → Environments có lịch sử deploy + nút Rollback.

• resource_group: production tạo mutex — chặn 2 deploy production đồng thời khi 2 MR merge gần nhau.

• Review Apps dùng $CI_MERGE_REQUEST_IID trong environment name để mỗi MR có namespace/URL riêng.

• on_stop + auto_stop_in: 7 days để GitLab tự dọn môi trường tạm khi MR đóng hoặc inactive.

Trong Phần 9 (cuối series), ta dựng pipeline production hoàn chỉnh Next.js → Docker → K8s, kèm best practices và kỹ thuật debug khi pipeline lỗi.

Phần 9: Pipeline thực tế Next.js → Docker → K8s + best practices + debug →