Manage Applications

ZCP console cho phép bạn quản lý thông tin cơ bản của ứng dụng, bao gồm:

• Quản lý tên ứng dụng
• Quản lý kho mã nguồn để xây dựng
• Quản lý kho hình ảnh để triển khai sau khi xây dựng

Bạn có thể chọn tên của ứng dụng từ màn hình tìm kiếm ứng dụng hoặc nhấp vào nút chi tiết trong menu Hành động để xem ứng dụng một cách chi tiết.

Màn hình chi tiết được tổ chức thành ba tab: Tổng quan, Thông tin cơ bản và Quy trình xây dựng

Tổng quan

Trên tab Tổng quan, bạn có thể xem danh sách các quy trình của ứng dụng và thông tin về từng quy trình.

• Name: Tên quy trình để xác định quy trình.

• Branch: Tên của nhánh để kiểm tra mã nguồn khi thực hiện xây dựng.

• Tag Prefix: Tên tiền tố được thêm vào tên thẻ khi tự động tạo thẻ trong quá trình xây dựng. Chỉ hợp lệ nếu Tự động gán thẻ được đặt thành Có.

• Last Created Image: URL của Hình ảnh được tạo ra lần cuối khi quy trình này chạy.

• Last Build: Thời gian quy trình xây dựng cuối cùng được thực hiện.

• Build Status: Kết quả của quá trình xây dựng, với mỗi biểu tượng có nghĩa là Xây dựng thành công, Xây dựng thất bại hoặc Đang chạy.

• Actions: Các nút để thực hiện các hành động trên quy trình, chẳng hạn như xem lịch sử/log và chạy một quy trình xây dựng.

Xây dựng một ứng dụng

Màn hình tab Tổng quan hiển thị danh sách các quy trình trong ứng dụng của bạn. Bạn có thể thực hiện một quy trình xây dựng bằng cách nhấp vào biểu tượng Xây dựng trên Actions của quy trình bạn muốn xây dựng:

Trong cửa sổ pop-up Build, bạn có thể xem nhật ký của quá trình xây dựng. Bạn có thể đóng pop-up bằng cách nhấp vào nút OK, lúc đó quá trình xây dựng sẽ tiếp tục ở phía máy chủ và lịch sử xây dựng sẽ được cập nhật khi quá trình xây dựng hoàn tất.

Trong khi quá trình xây dựng đang diễn ra, bạn có thể dừng quá trình xây dựng bằng cách nhấp vào nút Build Abort:

Xem Lịch Sử Xây Dựng Ứng Dụng

Màn hình tab Tổng quan hiển thị danh sách các pipeline trong ứng dụng của bạn. Bạn có thể xem lịch sử xây dựng bằng cách nhấp vào biểu tượng Lịch sử trên Actions của pipeline mà bạn muốn kiểm tra:

Lịch sử thực thi của lần xây dựng cuối cùng được hiển thị trong giao diện thẻ:

Chi tiết của từng mục được hiển thị bên dưới:

1. Biểu tượng kết quả chạy cho quá trình xây dựng. Có ba trạng thái: xây dựng thành công, xây dựng thất bại và đang chạy.
2. Một tóm tắt về kết quả xây dựng.
   • Build No: Số hiệu xây dựng. Số hiệu xây dựng được tự động chọn mỗi khi một quá trình xây dựng được thực hiện. Mỗi pipeline có số hiệu xây dựng riêng. Nội dung trong dấu ngoặc là kết quả xây dựng.
   • Build Time: Thời gian bắt đầu của quá trình xây dựng và thời gian kết thúc của quá trình xây dựng. Phía bên phải hiển thị tổng thời gian của quá trình xây dựng.
   • Image: URL của Hình ảnh là kết quả của quá trình chạy xây dựng. Nó bao gồm Registry Hình ảnh, dự án, kho lưu trữ và số thẻ.
   • Branch: Tên nhánh của mã nguồn được sử dụng để thực hiện quá trình xây dựng.

• User ID: ID của người dùng đã thực hiện việc xây dựng này.

1. Nút xem nhật ký xây dựng.

Các giai đoạn thực thi của pipeline xây dựng được cấu trúc thành Các Nhiệm Vụ (menu cha) và Các Bước (menu con). Thông thường, các nhiệm vụ được chia thành ba giai đoạn: Source Checkout, Build, và Image Build & Push. Nếu không có công cụ xây dựng cụ thể nào được cấu hình cho pipeline, chỉ có các giai đoạn Source Checkout và Image Build & Push sẽ được thực hiện. Bạn có thể nhấp vào mỗi giai đoạn để xem nhật ký thực thi cho giai đoạn đó.

Xem Nhật Ký Xây Dựng

Đây là màn hình chi tiết nhật ký được xuất ra bởi nút Xem Nhật Ký Xây Dựng:

1. Phần thông tin Xây dựng.
2. Phần Các Bước Xây dựng. Các xây dựng được thực hiện theo ba bước khác nhau, và mỗi lựa chọn bước sẽ xuất ra nhật ký cho bước đó.
   • Result: Hiển thị kết quả của việc chạy xây dựng. Nếu một xây dựng đang chạy, một vòng quay sẽ được hiển thị.
   • Source: URL kho lưu trữ của mã nguồn được sử dụng khi xây dựng.
   • Artifact: Thông tin về đầu ra của việc xây dựng. Đây là URL của Hình ảnh sẽ được tạo ra bởi việc xây dựng này.
3. Phần Nhật ký, hiển thị nhật ký của việc xây dựng đang chạy theo thời gian thực. Bạn cũng có thể xem nhật ký từ các xây dựng trước đó đã hoàn thành.
4. Nhấp vào nút OK để đóng màn hình popup nhật ký xây dựng.

Pipeline Ứng Dụng

Một ứng dụng có thể tạo nhiều pipeline xây dựng, mỗi pipeline có thể được cấu hình bằng cách chỉ định buildBranch, buildTool và buildOption để tổ chức pipeline. Ngoài ra, bạn có thể giới hạn số lượng lịch sử xây dựng và thiết lập việc gán nhãn cho các hình ảnh sẽ được triển khai.

• Pipeline Name: Một tên để người dùng nhận diện pipeline.
• Branch: Tên của nhánh mà mã nguồn sẽ được kiểm tra khi pipeline chạy. Bạn có thể xây dựng nhiều nhánh trong một kho mã nguồn, mỗi nhánh có một pipeline riêng. Ví dụ, một ứng dụng với các nhánh develop, staging và master có thể có một pipeline riêng cho mỗi nhánh.
• Build History: Đặt số lượng lịch sử xây dựng để quản lý.
• Build Tool: Chọn công cụ xây dựng để sử dụng khi xây dựng. Các công cụ xây dựng được hỗ trợ là Maven, Gradle và NPM. Nếu bạn cần sử dụng một công cụ xây dựng không được hỗ trợ (ant, yarn, v.v.), bạn sẽ cần đặt mục Công cụ Xây dựng thành None và thực hiện xây dựng bên trong một Dockerfile.

  • Maven:

    • Jdk Version: Chỉ định phiên bản của JDK để xây dựng.
    • Maven Goals: Chỉ định các lệnh Maven. Thông thường, chúng tôi sử dụng một mục tiêu gọi là package để tạo ra một artifact.
    • Mirror Url: Nếu bạn không có quyền truy cập trực tiếp vào một kho Maven công cộng, hãy sử dụng Nexus hoặc Artifactory hoạt động như một gương. Bạn có thể chỉ định đường dẫn đến gương để sử dụng khi xây dựng Maven. Gương phải công khai (có thể truy cập mà không cần ID hoặc mật khẩu).

  • Gradle:

    • Jdk Version: Chỉ định phiên bản của JDK để xây dựng.
    • Gradle Task: Tên của tác vụ Gradle để sử dụng để tạo ra các artifact khi xây dựng Gradle. Thông thường, buildNeeded được sử dụng, và nếu đó là một ứng dụng Spring Boot, BootJar cũng thường được sử dụng.
• Gradle Properties: Chỉ định giá trị của thuộc tính được sử dụng trong thời gian xây dựng dưới dạng key=value. Nó cũng được sử dụng để ghi đè giá trị trong tệp gradle.properties.

  • Command line options: Bạn có thể nhập các tùy chọn bổ sung có thể được thêm vào lệnh gradle khi chạy quá trình xây dựng.

  • NPM: Mặc định là root nếu không có đầu vào nào được cung cấp.

    • Node Version: Chỉ định phiên bản của Node để xây dựng.
    • NPM task command exclude install: Chỉ định lệnh tác vụ để thực hiện khi xây dựng. Tác vụ Cài đặt được xác định bởi Cài đặt Y/N bên dưới.
    • Remove cache Y/N: Xác định xem có xóa bộ nhớ cache và các mô-đun phụ thuộc đã lưu từ các lần xây dựng trước hay không.
    • Install Y/N: Xác định xem có thực hiện cài đặt npm hay không.
    • Context Path: Chỉ định đường dẫn tương đối đến package.json, kịch bản cơ bản của quá trình xây dựng NPM.
  • None:
    • Nếu bạn chỉ định Công cụ xây dựng là None, nó sẽ chỉ xây dựng Container bằng cách sử dụng một Dockerfile.
• Dockerfile Path: Chỉ định đường dẫn đến Dockerfile sẽ được sử dụng khi xây dựng hình ảnh. Bạn có thể sử dụng các Dockerfile khác nhau cho các pipeline khác nhau. Nếu không được chỉ định, Dockerfile được chỉ định trong Thông tin cơ bản sẽ được sử dụng. Nếu không được chỉ định trong Thông tin cơ bản, Dockerfile trong gốc của Kho lưu trữ Nguồn sẽ được sử dụng theo mặc định.
• Auto Tagging: Đặt xem có tự động tạo một Thẻ cho Hình ảnh được tạo ra khi Hình ảnh được xây dựng hay không. Nếu được đặt thành Có, số xây dựng tự động được tạo sẽ được sử dụng làm thẻ cho Hình ảnh mỗi khi một lần xây dựng được thực hiện. Nếu không được đặt thành Có, người dùng phải nhập thủ công thẻ Hình ảnh mỗi khi một lần xây dựng được thực hiện.
• Tag Prefix: Xác định một tiền tố cho tên thẻ khi thực hiện Gán thẻ tự động. Cài đặt này chỉ cần thiết nếu Gán thẻ tự động là Có. Ví dụ, nếu Tiền tố thẻ là dev, tên thẻ sẽ được tự động tạo ra là dev-1, dev-2.…