Konsep Dasar

Beberapa istilah yang dipakai Raklane — Organization, Project, App, Build, Release, Workload, Domain — dijelaskan dengan bahasa sederhana.

Ada beberapa istilah yang muncul di seluruh dokumentasi dan dashboard. Tidak ada yang rumit, tetapi beberapa di antaranya (terutama Release vs. Build vs. Workload) punya arti yang cukup spesifik di Raklane sehingga layak dibaca sekali.

Organization

Wadah tingkat akun tempat semua hal lain berada. Anda otomatis mendapat Organization pribadi saat mendaftar. Setiap Project milik tepat satu Organization, dan setiap orang yang Anda undang untuk berkolaborasi diundang ke sebuah Organization, dengan peran (owner, admin, developer, atau viewer) yang menentukan apa yang boleh mereka lakukan. Lihat Tim & Organisasi.

Project

Folder untuk aplikasi-aplikasi yang saling terkait — misalnya frontend dan backend untuk satu produk. Project berada di dalam sebuah Organization.

App

Aplikasi Anda. App adalah identitas yang stabil — nama dan tipe — yang tetap ada melampaui deploy mana pun. Inilah yang Anda anggap sebagai "aplikasi saya", entah sedang ada yang berjalan atau tidak.

Setiap App punya salah satu dari dua tipe, dipilih saat dibuat dan tidak bisa diubah setelahnya:

  • Deployment — di-build dari kode sumber Anda dengan Cloud Native Buildpacks dan dijalankan sebagai container.
  • Static — disajikan apa adanya, tanpa langkah build, tanpa proses di sisi server.

App Source

Asal kode App Anda: URL repositori Git dan ref (branch/tag/commit), atau arsip yang diunggah. Anda bisa mengubahnya kapan saja — deploy berikutnya memakai sumber yang sedang dikonfigurasi.

Build

Satu kali percobaan mengubah kode sumber App menjadi container image yang bisa dijalankan. Setiap deploy memulai Build baru. Sebuah Build bisa berhasil atau gagal, terlepas dari apakah ia akhirnya di-deploy atau tidak.

Release

Satu versi App yang di-deploy. Release menunjuk ke Build tertentu dan punya statusnya sendiri: deploying → active (atau failed/canceled). Hanya ada satu Release yang active pada satu waktu — itulah yang menerima trafik. Saat Anda deploy lagi, Release baru dibuat; setelah sehat, trafik dipindahkan ke sana dan Release lama dipensiunkan.

Workload

Satu instance container yang berjalan di balik sebuah Release. Jika Anda menjalankan beberapa replica, Release Anda punya beberapa Workload yang melayani trafik yang sama. Inilah yang dipantau Raklane untuk memastikan aplikasi Anda benar-benar hidup, dan yang di-restart jika container crash.

Domain

Hostname yang diarahkan ke App Anda. Setiap App otomatis mendapat subdomain gratis begitu di-deploy. Anda juga bisa menambahkan domain kustom sendiri (app.perusahaananda.com) — lihat Domain Kustom.

Environment Variable

Pasangan key/value yang disuntikkan ke container App saat deploy. Perubahan baru berlaku pada deploy berikutnya — container yang sedang berjalan tidak membaca perubahan secara live. Lihat Environment Variable.

Secret

Nilai sensitif yang disimpan Raklane untuk Anda dan dirujuk lewat ID alih-alih ditampilkan sebagai teks biasa — paling umum berupa access token repositori privat atau kunci penandatanganan webhook.

Database

Instance Postgres atau MySQL terkelola yang dimiliki sebuah Project, bukan satu App tertentu — App mana pun di project itu bisa terhubung, dan database tetap berjalan terlepas dari deploy aplikasi. Lihat Database.

Lokasi deploy

Tempat App berjalan: PAYG cluster (compute terkelola Raklane, ditagih per resource), Dedicated cluster (compute terkelola Raklane, dari langganan harga tetap), atau BYOC (server milik Anda). Dipilih saat membuat App, dan bisa diubah nanti. Lihat Tempat Aplikasi Berjalan.

Cluster & Node

Cluster adalah tempat Raklane bisa menjalankan App dan Database Anda. Node adalah mesin individual di dalam cluster yang benar-benar menjalankan container Anda.

  • Cluster terkelola milik Raklane bisa punya banyak node, yang ditambah dan dikurangi Raklane sesuai kebutuhan — Anda tidak perlu mengelolanya.
  • Setiap server yang Anda daftarkan lewat Bring Your Own Compute menjadi cluster BYOC tersendiri dengan tepat satu node: server itu sendiri.

Node Agent

Layanan latar belakang kecil yang dipasang Raklane di server BYOC. Agent membuka satu koneksi keluar yang terenkripsi ke Raklane dan menjalankan instruksi di server — menarik image, menyalakan dan mematikan container, memperbarui rute, dan melaporkan kesehatan. Lihat BYOC: Gambaran Umum & Cara Kerja.

Dompet (Wallet)

Saldo prabayar Anda. Setiap biaya — pemakaian PAYG, langganan, hosting database, biaya pengelolaan BYOC — dipotong dari sini. Lihat Tagihan & Dompet.

Bagaimana semuanya saling terkait

Alur yang umum: Anda membuat Project dan App di dalamnya, mengarahkan App ke kode sumber, memilih lokasi deploy, lalu deploy. Itu memicu Build; setelah berhasil, Release dibuat dan Workload mulai berjalan di sebuah Node dalam Cluster yang dipilih. Trafik mencapai Workload tersebut melalui Domain yang mengarah ke App.

Untuk penjelasan lengkapnya, lihat Cara Kerja Raklane.