dig-cli

DI BUILD SERVER

A BUILD SERVER that run on your infrastructure and its Command Line Interface (CLI) with developer-friendly commands - a must-have tool of DevOps engineers.

Developers should not be frustrated by deploying their apps to the infrastructure, or bothering the DevOps engineers to help deploying it, they should fully focus on developing apps, they don't need to understand the servers, the domains, or infrastructure related stuffs. That's when di come, di is your DevOps assistant.

| Build faster. Deploy easier. More flexible.

---

DOCUMENTATION

CHANGELOG

---

Installation

Prerequisites

Requires

• Install jq trong máy của bạn: https://stedolan.github.io/jq/download/
• Install Docker trong máy của bạn: https://docs.docker.com/engine/install/
• Install kubectl trong máy của bạn: https://docs.docker.com/engine/install/

Optional

• Install gcloud: https://cloud.google.com/sdk/docs/install#installation_instructions
• Install doctl: https://docs.digitalocean.com/reference/doctl/

---

Getting Started

# Pull & cài đặt CLI
git clone [e-mail]:digitopvn/diginext-cli.git
cd /path/to/diginext-cli

# Run this command to install
./shells/install.sh

Next:

# trong vài trường hợp thiếu permission, thử command sau:
sudo npm link

# Hoặc: `chmod -R 755 /path/to/diginext-cli`

# Đăng nhập BitBucket
diginext git login

# 1. tự động mở browser báo đăng nhập BitBucket & grant access permissions
# 2. browser sẽ redirect qua google.com/?token=XXXXXXXX
# 3. quay lại CLI nhập Bitbucket USERNAME (VD: duynguyen123) - USERNAME chứ không phải EMAIL -> Enter
# 4. CLI hỏi Bitbucket token -> copy & paste token (trên URL, VD: XXXXXXXX) vào CLI -> Enter
# 5. DONE!

# Authenticate Google Cloud:
diginext auth

---

Contributing

Hướng dẫn develop CLI

1. Clone repo về máy cá nhân.
2. Tách nhánh master về máy của mình: dev/{myusername}
3. Develop tính năng mới.

Hướng dẫn test CLI

1. Run CLI SERVER locally: docker-compose -f docker-compose.build.yaml up --build
2. Test command để deploy: DEV_MODE=true diginext deploy [...]

Chuẩn bị cho việc release CLI new version:

1. Test test & test !!!

2. Chuẩn bị:

   • Cập nhật README.md nếu có
   • Cập nhật deploy_guide.md nếu có
   • Cập nhật version mới trong package.json

3. Build Docker & push lên DockerHub với lệnh bên dưới:

   • BETA: ./shells/beta (hoặc bash ./shells/beta4win trên Windows)
   • OFFICIAL: ./shells/release (hoặc bash ./shells/release4win trên Windows)

4. Kiểm tra log xem có release thành công chưa.

5. Hoàn tất!

Deploy CLI SERVER lên DEV4 (BUILD SERVER)

1. SSH vào DEV4
2. Tìm tới directory: /var/tools/diginext-cli
   • (2.1. Backup file docker-compose.yaml trên server)
3. Upload docker-compose.yaml vào /var/tools/diginext-cli
4. Hạ CLI SERVER cũ xuống docker-compose down
5. Run CLI SERVER mới: docker-compose up -d
6. Kiểm tra lại: https://deploy.digitop.vn

---

Hướng dẫn start BUILD SERVER trên SERVER CENTOS mới

Tutorial

• Dùng docker-compose.nginx.yaml

---

Autorenew SSL

• chmod +x ssl_renew.sh
• sudo crontab -e
• Chọn (2) /bin/nano
• Add cuối cùng: [check mỗi 5 phút] */5 * * * * /home/sammy/node_project/ssl_renew.sh >> /var/log/cron.log 2>&1
• Check xem cronjob có chạy không: tail -f /var/log/cron.log

---

Build server

• Location: DEV4 (128.199.149.106)
• Domain: https://deploy.digitop.vn/
• Engine: Docker Compose
• Directory: /var/tools/diginext-cli
• Startup script: docker-componse up -d
• Repositories (Cached): /mnt/build
• Docker data: /mnt/docker-data
• Clean up (flush cache to release disk space): docker image prune -af --filter "until=168h" (delete images which a week old)

---

Community and Support:

Join our community on Discord!

Suggest improvements and report problems.

---

Author: Boss Duy Nguyen [e-mail]