DevOps Bootcamp · Pelajaran

Aksi Komposit dan Publikasi ke Marketplace

Bangun aksi komposit yang menggabungkan beberapa langkah, beri versi dengan benar, dan publikasikan aksi khusus Anda ke GitHub Marketplace agar dapat digunakan kembali.

Aksi Komposit dan Publikasi ke Marketplace adalah pelajaran DevOps Bootcamp gratis di CoddyKit. Ini adalah pelajaran 4 dari 4. Kamu bisa membaca pelajaran lengkapnya di bawah secara gratis — lalu praktikkan langsung di browser dengan editor kode bawaan dan tutor AI 24/7. Ini adalah bagian dari jalur belajar DevOps Bootcamp, dan progresmu tersinkronisasi di web dan aplikasi CoddyKit. Kursus DevOps Bootcamp mencakup 4 pelajaran total.

Tiga Jenis Action Kustom

GitHub mendukung tiga cara untuk membuat action kustom:

Action JavaScript — menjalankan kode Node
Action Docker — berjalan di dalam container
Action Composite — menggabungkan beberapa langkah workflow

Pelajaran ini berfokus pada action composite dan publikasi.

Apa Itu Action Composite

Action composite mengemas beberapa langkah run dan pemanggilan action lain menjadi satu unit yang dapat digunakan kembali, tanpa menulis JavaScript atau membangun image Docker.

Action ini ideal untuk merangkum rangkaian perintah shell yang berulang.

File action.yml

Setiap action didefinisikan oleh action.yml di direktori akarnya. Untuk action composite, tetapkan runs.using ke composite.

name: Setup Project
description: Install deps and build
runs:
  using: composite
  steps:
    - run: npm ci
      shell: bash
    - run: npm run build
      shell: bash

Shell Wajib Diisi

Aturan penting: dalam action composite, setiap langkah run harus mendeklarasikan shell. Lupa mendeklarasikannya adalah error yang paling umum saat membuat composite.

    - run: echo 'hello'
      shell: bash

Mendefinisikan Input

Buat action agar dapat dikonfigurasi dengan inputs. Pemanggil meneruskan nilai melalui with, dan Anda merujuknya sebagai inputs.<name>.

inputs:
  node-version:
    description: Node version
    required: false
    default: '20'
runs:
  using: composite
  steps:
    - run: echo Using ${{ inputs.node-version }}
      shell: bash

Mendefinisikan Output

Sebuah tindakan komposit dapat mengembalikan output. Sebuah langkah menulis ke GITHUB_OUTPUT, lalu tindakan tersebut memetakannya ke output bernama.

outputs:
  build-id:
    value: ${{ steps.gen.outputs.id }}
runs:
  using: composite
  steps:
    - id: gen
      run: echo "id=$(date +%s)" >> $GITHUB_OUTPUT
      shell: bash

Menggunakan Tindakan Lokal

Anda dapat mereferensikan tindakan yang disimpan di repositori yang sama berdasarkan jalurnya. Cara ini sangat berguna saat mengembangkan tindakan sebelum menerbitkannya.

    steps:
      - uses: actions/checkout@v4
      - uses: ./.github/actions/setup-project
        with:
          node-version: '20'

Pemberian Versi dengan Tag

Tindakan yang diterbitkan direferensikan berdasarkan ref git. Praktik terbaiknya adalah memberi tag pada rilis seperti v1.0.0 dan juga mempertahankan tag v1 yang terus diperbarui.

Pemanggil yang menggunakan @v1 akan otomatis mendapatkan pembaruan yang tidak menyebabkan perubahan yang merusak.

git tag -a v1.0.0 -m 'release'
git tag -f v1
git push --tags --force

Persiapan untuk Marketplace

Untuk menerbitkan tindakan ke pasar GitHub, tindakan tersebut harus berada di repositori publik dengan action.yml yang berisi name, description, dan idealnya branding (ikon dan warna).

branding:
  icon: package
  color: blue

Menerbitkan Rilis

Di halaman Rilis repositori, buat draf rilis untuk tag Anda. GitHub menampilkan kotak centang Terbitkan Tindakan ini ke Marketplace.

Setujui perjanjian, pilih kategori, lalu terbitkan. Tindakan tersebut dapat dicari oleh semua orang.

Mendokumentasikan Penggunaan

Tindakan yang baik disertai README yang jelas dan menampilkan contoh penggunaan, input, serta output.

Perusahaan yang mengevaluasi tindakan Anda sangat bergantung pada dokumentasi ini, jadi pastikan isinya akurat dan lengkap.

Pemeriksaan Singkat

Uji pemahaman Anda tentang tindakan komposit.

Rangkuman

Anda telah mempelajari cara membuat dan menerbitkan tindakan komposit.

Tindakan komposit menggabungkan langkah-langkah melalui runs.using: composite
Setiap langkah eksekusi memerlukan shell yang dinyatakan secara eksplisit
Gunakan input dan output agar tindakan dapat digunakan kembali
Gunakan tag dengan versi semantik dan tag mayor yang terus diperbarui, lalu terbitkan ke Marketplace

Tindakan yang dapat digunakan kembali membantu tim memperluas logika CI/CD bersama.

Pertanyaan yang Sering Diajukan

Apakah pelajaran “Aksi Komposit dan Publikasi ke Marketplace” gratis?

Ya — teks lengkap “Aksi Komposit dan Publikasi ke Marketplace” gratis dibaca di sini di web. Untuk praktiknya secara interaktif (editor kode bawaan dan tutor AI 24/7) dan buka sisa kursus DevOps Bootcamp, upgrade ke CoddyKit PRO. Kursus DevOps Bootcamp mencakup 4 pelajaran total.

Apa yang akan aku pelajari di “Aksi Komposit dan Publikasi ke Marketplace”?

Bangun aksi komposit yang menggabungkan beberapa langkah, beri versi dengan benar, dan publikasikan aksi khusus Anda ke GitHub Marketplace agar dapat digunakan kembali. Kamu berlatih DevOps Bootcamp dengan kode praktik yang langsung kamu jalankan di browser, dan tutor AI 24/7 menjawab pertanyaanmu saat kamu mengerjakan pelajaran ini.

Apakah aku perlu pengalaman untuk memulai DevOps Bootcamp?

Tidak diperlukan pengalaman sebelumnya. DevOps Bootcamp di CoddyKit dirancang untuk pemula hingga pelajar tingkat lanjut, jadi kamu bisa memulai di sini atau dari awal dan belajar sesuai kecepatan kamu sendiri. Ini adalah pelajaran 4 dari 4.

Berapa lama pelajaran “Aksi Komposit dan Publikasi ke Marketplace” memakan waktu?

Sebagian besar pelajaran CoddyKit memakan waktu sekitar 5–10 menit. Setiap pelajaran ringkas dan interaktif, jadi kamu membuat kemajuan stabil dan melanjutkan dari tempat kamu tinggalkan di web dan aplikasi.

Bisakah aku menulis dan menjalankan kode dalam pelajaran DevOps Bootcamp ini?

Ya. Setiap pelajaran DevOps Bootcamp menyertakan editor kode bawaan, jadi kamu menulis dan menjalankan kode nyata langsung di browser dan mendapatkan umpan balik AI instan — tidak diperlukan penyiapan lokal.

Semua pelajaran dalam kursus ini

Mengembangkan GitHub Actions Khusus
Pelaksana yang Dihosting Sendiri untuk Lokal
Mengintegrasikan Sistem Perusahaan
Aksi Komposit dan Publikasi ke Marketplace

← Kembali ke DevOps Bootcamp