Setup lokal

Halaman ini nyiapin mesin lu buat berkontribusi ke salah satu dari tiga repo. Total waktunya sekitar dua puluh menit pas pertama kali, dan semua yang di sini gratis.

Akun

Bikin atau login ke GitHub

Semua kontribusi lewat GitHub. Login di github.com, terus fork repo yang mau lu ubah. Lu gak pernah push langsung ke repo utama; lu push ke fork lu dan buka pull request.

Dapetin token API Biznet GIO

Provider ngobrol sama Biznet GIO pake token API, yang dibikin dari portal kayak yang dijelasin di Authentication. Lu cuma butuh ini buat jalanin plan, apply, preview, atau up. Cek statis kayak terraform validate dan pulumi preview pake mocks tetep jalan tanpa itu.

Opsional: bikin akun Pulumi Cloud

Ngejalanin contoh Pulumi dengan state asli butuh akun Pulumi Cloud gratis, dan pipeline CI butuh personal access token dari situ. Skip ini sampe lu beneran ngejalanin sesuatu.

Tools

Install persis versi yang proyek ini pake. Pipeline CI ngepin yang sama, jadi perubahan yang build di mesin lu juga build di CI:

Tool	Versi	Di mana di-pin	Link install
Git	yang terbaru aja	gak di-pin	git-scm.com
Terraform	1.0 atau lebih baru	`versions.tf` di tiap folder	developer.hashicorp.com
Pulumi CLI	terkini	gak di-pin	pulumi.com
Node.js	20	CI `node-version`	nodejs.org
Python	3.11	CI `python-version`	python.org
Go	1.25.x	`go.mod` dan CI `go-version`	go.dev
.NET SDK	8.0.x	`.csproj` `net8.0` dan CI	dotnet.microsoft.com
Java (Temurin)	17	`pom.xml` dan CI	adoptium.net
Maven	terkini	gak di-pin	maven.apache.org
Mintlify CLI	terkini	gak di-pin	`npm i -g mint`

Go 1.25 bukan typo. go.mod Pulumi Go SDK ngedeclare requirement toolchain yang baru, jadi versi Go lama nolak buat build. Kalau lu liat error go: go.mod requires go >= 1.25, update Go.

Lu gak butuh keenam toolchain bahasa Pulumi. Install yang mau lu kontribusiin. Pipeline CI ngejalanin keenamnya buat lu kok.

Clone dan first run

Tiga repo itu clone git biasa:

git clone https://github.com/shirasakaren/biznetgio-docs.git
git clone https://github.com/shirasakaren/biznetgio-example-terraform.git
git clone https://github.com/shirasakaren/biznetgio-example-pulumi.git

Perintah ini clone repo upstream langsung. Kalau lu mau kirim pull request, fork dulu terus clone fork lu, caranya sama. Terus verifikasi tiap repo jalan di mesin lu.

Situs docs

cd biznetgio-docs
npm i -g mint     # one time, installs the Mintlify CLI
mint dev          # preview at http://localhost:3000

Tiap perubahan yang disimpan hot-reload. Preview lokal itu cara terbaik buat cek MDX sebelum commit.

Contoh Terraform

cd biznetgio-example-terraform/object-storage
terraform fmt -check
terraform init
terraform validate

Ketiga command harus lolos. Mereka gak butuh credential; terraform validate itu cek statis yang gak pernah manggil API Biznet GIO.

Contoh Pulumi

Satu command build per bahasa, dari dalam folder contoh:

cd biznetgio-example-pulumi/typescript/neolite
npm install && npx tsc --noEmit

cd ../../python/neolite
pip install -r requirements.txt

cd ../../go/neolite
go build ./...

cd ../../dotnet/neolite
dotnet build

cd ../../java/neolite
mvn -q compile

YAML gak butuh build; parser YAML apa pun yang nerima yaml/neolite/Pulumi.yaml itu udah jadi ceknya.

Secrets CI, buat maintainers

Pipeline repo contoh jalan pake manual dispatch dan kebanyakan actions butuh repo secrets. Konfigurasi ini di Settings > Secrets and variables > Actions fork lu kalau mau jalanin pipeline lengkap dari fork lu sendiri:

Secret	Di mana	Dibutuhin oleh
`BIZNETGIO_API_KEY`	dua repo contoh	`plan`/`apply`/`destroy` (Terraform), `preview`/`up`/`destroy` (Pulumi)
`EXAMPLE_CONSOLE_PASSWORD`	contoh terraform	`plan`/`apply`/`destroy` di folder yang nerima console password
`PULUMI_ACCESS_TOKEN`	contoh pulumi	`preview`/`up`/`destroy`

Gak usah set ini kecuali lu beneran niat. apply, up, dan destroy bikin order asli di akun yang token-nya lu konfigurasi, itu persis kenapa pipelines-nya cuma manual. Liat Pipelines buat penjelasan lengkap.

Lu udah siap

Dari sini, baca Konvensi biar perubahan pertama lu cocok sama gaya rumah, terus pilih walkthrough dari guide step-by-step.

Berkontribusi

Di balik layar

Akun

Tools

Clone dan first run

Situs docs

Contoh Terraform

Contoh Pulumi

Secrets CI, buat maintainers

Lu udah siap

​Akun

​Tools

​Clone dan first run

​Situs docs

​Contoh Terraform

​Contoh Pulumi

​Secrets CI, buat maintainers

​Lu udah siap

Akun

Tools

Clone dan first run

Situs docs

Contoh Terraform

Contoh Pulumi

Secrets CI, buat maintainers

Lu udah siap