Skip to main content
Phong Nguyen
💬
0 discussions

Hướng dẫn Publish gcallsconfig lên Gitlab Package Registry

1. Điều kiện tiên quyết​

  • Tài khoản Gitlab
  • Tài khoản NPM (devops_gcalls)

2. Đối tượng đọc​

  • Stage Owner
  • Customer Success Engineer
  • Customer Success Specialist

3. Publish to Gitlab Package Registry​

3.1 Giới thiệu Gitlab Package Registry​

  • Sử dụng để lưu trữ Private package (tương tự NPM package). Các Project để có thể install Private package phải có "Deploy tokens"
  • "Deploy tokens" được tạo và hiển thị giá trị một lần duy nhất tại (bạn có thể Revoke và tạo lại):
  • Giá trị "Deploy tokens" này được khai báo tại file .env của callbox với key là NPM_TOKEN và được sử dụng tại file .npmrc

3.2. Clone sourcecode gcallsconfig & callbox​

git clone https://gitlab.com/gcalls/secrets/gcallsconfig -b Test
git clone https://gitlab.com/gcalls/publics/omnibox/callbox -b Test

3.3. Develop and Test locally gcallsconfig​

  • Vào sourcecode gcallsconfig copy file config.json vào thư mục gốc của gcallsconfig.
  • Tạo file .env từ file .env.example, điền vào những giá trị phù hợp (chú ý giá trị của CONFIG_KEY sẽ cùng giá trị với .env của callbox)
  • Sau đó chạy lệnh:
npm run dev
  • Vào sourcecode callbox, chỉnh sửa file package.json sao cho đường dẫn của dependencies @gcalls/gcallsconfig đúng với path sourcecode gcallsconfig
"@gcalls/gcallsconfig": "file:../gcallsconfig",
npm run installpackage
  • Sau khi hoàn thành developing and testing thì vào callbox, chỉnh sửa file package.json trả giá trị version của dependencies @gcalls/gcallsconfig về như ban đầu.

Example:

"@gcalls/gcallsconfig": "^1.0.20",

3.4. Publish lên Gitlab Package Registry​

  • Vào sourcecode gcallsconfig cập nhật version mới trong file package.json

Example:

"version": "1.0.21",
  • Chạy lệnh để build project
npm run build

  • Sau khi build thành công, commit tất cả những thay đổi lên Gitlab. Tiến hành tạo merge request vào branch Test.

  • Sau khi merged vào Test, vào kiểm tra Pipelines đã run thành công.

  • Sau khi Pipelines đã run thành công, tiến hành kiểm tra thông tin ngày và version published đã chỉnh xác chưa tại Package Registry.

    Example:

3.5 Cập nhật version mới cho callbox​

  • Vào sourcecode callbox, cập nhật version mới nhất của @gcalls/gcallsconfig vừa được published.

Example:

"@gcalls/gcallsconfig": "^1.0.21",
  • Commit những thay đổi của callbox lên Gitlab.

4. Kết Luận​

Tài liệu này hướng dẫn kỹ sư mới cách developing, testing locally, publishing to the Gitlab Package Registry, nếu có góp ý xin vui lòng điền vào form bên dưới