Belajar GitHub Actions - Langkah-Langkah Workflow (Steps, Uses, & Run)

#Pendahuluan

Di episode 3 kalian sudah bisa menulis workflow dan memilih event trigger yang tepat. Sekarang kita masuk ke jantung setiap job: langkah-langkah (steps). Dua kata kunci yang akan menghiasi hampir semua workflow kalian adalah run dan uses — keduanya adalah dua cara berbeda untuk mengisi sebuah step.

run mengeksekusi perintah shell langsung, sedangkan uses memanggil action siap pakai dari GitHub Marketplace. Memahami kapan memakai yang mana, bagaimana menyusun command multi-baris, mengatur working directory, dan memilih versi action dengan benar, adalah keterampilan yang membedakan workflow yang rapuh dari workflow yang profesional.

#Pembahasan Utama

#Menjalankan Perintah Shell dengan run

run adalah cara paling langsung untuk mengeksekusi perintah di runner. Bentuk paling sederhana — satu baris:

steps:
  - name: Jalankan unit test
    run: npm test

Perhatikan bahwa default shell di runner Linux adalah bash dengan mode -e dan pipefail — jika perintah mengembalikan exit code bukan nol, step dianggap gagal dan pipeline berhenti.

Untuk beberapa perintah berurutan, gunakan literal block dengan |:

steps:
  - name: Install, lint, dan test
    run: |
      npm ci
      npm run lint
      npm test

Setiap baris di bawah run: | dieksekusi sebagai perintah terpisah dalam satu sesi shell yang sama. Ini penting: variabel yang di-set di baris pertama tetap bisa dipakai di baris berikutnya.

#Mengatur Working Directory

Terkadang kode yang mau di-build tidak berada di root repository — misalnya monorepo dengan folder frontend dan backend. Gunakan working-directory:

jobs:
  frontend:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Build frontend
        working-directory: ./frontend
        run: |
          npm ci
          npm run build

working-directory berlaku per step. Jika hampir semua step di sebuah job memakai direktori yang sama, kalian bisa mengatur default sekali untuk seluruh job lewat defaults:

jobs:
  frontend:
    runs-on: ubuntu-latest
    defaults:
      run:
        working-directory: ./frontend
        shell: bash
    steps:
      - uses: actions/checkout@v4
      - run: npm ci

Sekarang setiap step run di job frontend otomatis berjalan di ./frontend memakai shell bash — tanpa harus menuliskannya berulang-ulang.

#Menggunakan Action dari Marketplace dengan uses

run mengeksekusi perintah mentah, tetapi banyak pekerjaan yang sebaiknya diserahkan ke action — kode siap pakai yang sudah diuji jutaan kali. Sintaks dasarnya: uses: <owner>/<repository>@<versi>.

Empat action paling penting yang harus kalian kenal:

Contoh pemakaian setup-node dengan input:

steps:
  - uses: actions/checkout@v4
  - uses: actions/setup-node@v4
    with:
      node-version: 20
      cache: npm

Perhatikan bagian with — itulah cara mengirim input ke action. Action menerima parameter lewat with, menjalankan logikanya, dan (jika punya) menghasilkan output yang bisa dipakai step lain. cache: npm membuat action ini otomatis menangani caching dependensi — kita akan membahas caching lebih dalam di episode 8.

#Memilih Versi Action

Bagian setelah tanda @ menentukan versi action yang dipakai. Ada tiga cara:

Aturan emasnya: tag untuk keterbacaan, SHA untuk keamanan ekstrem. Tag seperti v4 bisa saja dipindah oleh pemilik action menunjuk ke commit lain — jarang terjadi, tapi mungkin. Bagi tim yang menangani supply chain security dengan serius, pindahkan action ke full commit SHA dan biarkan renovate bot yang memperbaruinya.

#Contoh Workflow CI Node.js Lengkap

Sekarang mari kita rakit semua materi menjadi satu workflow CI nyata untuk project Node.js:

name: Node.js CI
on: [push, pull_request]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout kode
        uses: actions/checkout@v4
      - name: Setup Node.js 20
        uses: actions/setup-node@v4
        with:
          node-version: 20
          cache: npm
      - name: Install dependensi
        run: npm ci
      - name: Lint
        run: npm run lint
      - name: Unit test
        run: npm test

Bisa kalian lihat pola yang konsisten dan akan kalian temui di hampir semua repository profesional: checkout → setup runtime → install dependensi → lint → test. Setiap perubahan di push atau pull request otomatis melalui proses ini, dan statusnya terlihat langsung di tab Checks setiap PR.

#Kesalahan Umum

1. Lupa checkout. Action setup-node membutuhkan isi repository? Tidak — justru setup-node tidak mengkloning kode. Tanpa actions/checkout@v4 di step pertama, runner kosong dan npm ci akan gagal.
2. Versi action tidak cocok. Setup action dan versi runtime adalah dua hal berbeda. setup-node@v4 adalah versi action-nya; node-version: 20 adalah versi Node.js yang dipasang.
3. run tanpa exit code yang benar. Jika skrip kalian exit 0 meskipun ada error, workflow tetap dianggap sukses. Pastikan skrip benar-benar mengembalikan exit code yang sesuai.

#Penutup

Pada episode 4 ini kalian telah menguasai isi dari setiap job:

• run untuk perintah shell: single-line, multi-line dengan |, working-directory, dan defaults.run.shell untuk default global job.
• uses untuk action Marketplace: checkout, setup-node, setup-python, dan setup-go, lengkap dengan input lewat with.
• Pemilihan versi action: tag untuk keterbacaan, commit SHA untuk keamanan, dan alasan menghindari branch.
• Workflow CI Node.js lengkap: pola checkout, setup runtime, install, lint, dan test.

Langkah-langkah kalian sekarang benar-benar terstruktur. Di episode 5 kita akan menambahkan kemampuan paling penting berikutnya: variabel, contexts, dan environment variables — bagaimana workflow kalian bisa memakai data konteks seperti siapa yang mengirim commit, menyimpan konfigurasi di vars, dan mengirim nilai antar step dengan GITHUB_ENV serta GITHUB_OUTPUT. Sampai jumpa di episode 5!