Deploy Service Go ke VPS dengan Resource Terbatas menggunakan Docker dan GitHub Actions, Emang Bisa?#

Apa Yang Diperlukan Untuk Tutorial Kali Ini?#

• Repository github yang sudah memiliki dockerfile / docker compose

• Akun Docker Hub

• Dan server / vps untuk deployment service

Langsung Gass Kita Coba#

Yang pertama pastikan kamu udah buat akun untuk docker hub, kalo belum bisa buatnya klik disini ketika sudah berada di dashboard cari bagian repository dan klik Create Repository dan isikan nama repository nya lalu klik Create Repository.

setelah itu kita harus membuat secret docker hub, klik pada bagian avatar -? di bagian atas -> Settings -> Secrets dan klik Personal Access Tokens lalu klik New Token dan isikan nama token nya dan token yang dihasilkan, klik Create Token setelah token terbuat copy secret nya.

Setting Up Environtment repo#

Yang kedua disini kita harus set env secret di github, dari halaman projek repository mu klik Settings And Variable -> Actions -> Repository Secrets dan klik New repository secret lalu isikan secret berikut sesuai dengan yang kamu punya:

Setting Up Workflow#

Disini kita buat dulu workflow di github action untuk membuild docker compose kita untuk pushing result build image nya ke docker hub, dan pulling image ke instance/vps pastiin dulu kalo repo mu udah ada docker-compose.yml nya yaaa~

dari tampilan repositori mu sekarang klik Actions dibagian atas kanan -> New Workflow dan isikan kode berikut:

build.yml

1
name: Build and Push to Docker Hub
2

3
on:
4
  push:
5
    branches: ["main"]
6

7
jobs:
8
  build-and-push:
9
    runs-on: ubuntu-latest
10

11
    steps:
12
      - name: Checkout code
13
        uses: actions/checkout@v4
14

15
      - name: Set up Go
16
        uses: actions/setup-go@v4
17
        with:
18
          go-version: "1.24.2"
19

20
      - name: Cache Go modules
21
        uses: actions/cache@v3
22
        with:
23
          path: |
24
            ~/.cache/go-build
25
            ~/go/pkg/mod
26
          key: ${{ runner.os }}-go-${{ hashFiles('**/go.sum') }}
27
          restore-keys: |
28
            ${{ runner.os }}-go-
29

30
      - name: Install dependencies
31
        run: go mod tidy
32

33
      - name: Log in to Docker Hub
34
        run: echo "${{ secrets.DOCKER_SECRET }}" | docker login -u "${{ secrets.DOCKER_USERNAME }}" --password-stdin
35

36
      - name: Build Docker image
37
        run: docker build -t ${{ secrets.DOCKER_USERNAME }}/namarepo-dockerhubmu:latest .
38

39
      - name: Push Docker image
40
        run: docker push ${{ secrets.DOCKER_USERNAME }}/namarepo-dockerhubmu:latest

kode diatas adalah template workflow yang kita gunakan untuk build service kita ke docker image di instance github action yang nantinya akan di push ke docker hub sebagai media penyimpanan image dan share image antar platform.

oiya sebelum lanjut ke kode dibawah, pastikan kamu udah setting up repository project mu ke vps/instance dengan directory yang udah kamu tentukan dan pastikan juga kamu udah menginstall docker dan docker compose di server mu.

pull.yml

1
name: Deploy via SSH
2

3
on:
4
  workflow_run:
5
    workflows: ["Build and Push to Docker Hub"]
6
    types:
7
      - completed
8

9
jobs:
10
  deploy:
11
    if: ${{ github.event.workflow_run.conclusion == 'success' }}
12
    runs-on: ubuntu-latest
13

14
    steps:
15
      - name: Deploy to VPS via SSH
16
        uses: appleboy/[email protected]
17
        with:
18
          host: ${{ secrets.VPS_HOST }}
19
          username: ${{ secrets.VPS_USER }}
20
          key: ${{ secrets.VPS_SSH_KEY }}
21
          port: ${{ secrets.VPS_PORT }}
22
          script: |
23
            cd /root/yourprojectrepo
24

25
            # Pull Latest Code From Github
26
            git pull origin main
27

28
            # Pull latest image from Docker Hub
29
            docker compose pull
30

31
            # Stop and remove running containers
32
            docker compose down
33

34
            # Rebuild and start services with latest image
35
            docker compose up -d --remove-orphans

Seperti sebelumnya, kode diatas adalah template workflow yang kita gunakan untuk pulling image terbaru dari docker hub ke instance VPS yang nantinya akan di run dengan docker compose.

Finishing Up#

Nah akhirnya kita udah sampai ke proses terakhir, disini kita bisa coba update repo mu untuk melihat hasil build dan deployment yang udah kita buat tadi sambil lihat docker logs nya jikalau ada yang belum sesuai bisa di perbaiki kembali :)

Kalau semua step udah jalan mulus, berarti kamu sekarang udah punya alur CI/CD sederhana yang bisa dipakai bahkan di VPS dengan resource terbatas 🎉.

Langkah selanjutnya, kamu bisa:

• Menambahkan service lain ke dalam docker-compose.yml.
• Setup notifikasi (misalnya ke Discord/Telegram) untuk tahu kalau deploy sukses/gagal.
• Optimasi Docker image supaya lebih kecil dan cepat ditarik di server.

Dengan cara ini, kamu nggak perlu lagi build langsung di VPS, cukup push code ke GitHub dan biarkan workflow yang urus deploymentmu :)

Akhir kata, Jikalau ada kesalahan atau ada yang ingin di tanyakan pada blog ini jangan ragu untuk menghubungi ku via dm di social media yang udah ku tampilkan, sekian :)