Buat Function

Pelajari cara membuat serverless function menggunakan antarmuka web dengan editor kode bawaan dan kemampuan pengujian.

Prasyarat link

Sebelum membuat function, pastikan:

• ✅ Anda memiliki akses ke dashboard NQRust-MicroVM
• ✅ Setidaknya satu host/agent online
• ✅ Resource yang cukup tersedia (minimum: 1 vCPU, 512 MB RAM per function)

Langkah 1: Buka Halaman Pembuatan Function link

1. Klik Functions di sidebar kiri
2. Klik tombol New Function di sudut kanan atas

Editor function akan terbuka dengan editor kode Monaco.

Langkah 2: Konfigurasi Dasar link

Nama Function (Diperlukan) link

Masukkan nama unik dan deskriptif untuk function Anda:

• Harus antara 1-50 karakter
• Gunakan nama deskriptif yang menunjukkan tujuan
• Contoh: image-resizer, email-sender, data-processor

Tips: Gunakan kebab-case untuk nama function (mis., process-payment, send-notification)

Runtime (Diperlukan) link

Pilih bahasa pemrograman untuk function Anda:

Runtime yang tersedia:

Default: TypeScript

Catatan performa: Semua runtime memiliki waktu cold start yang serupa (~2-3 detik)

Nama Handler (Diperlukan) link

Tentukan nama function entry point:

• Default: handler
• Harus sesuai dengan nama function dalam kode Anda
• Nama umum: handler, main, lambda_handler

Contoh:

  # Jika handler = "handler"
def handler(event):
    return {"statusCode": 200}
  

  // Jika handler = "handler"
export async function handler(event) {
  return { statusCode: 200 };
}
  

Langkah 3: Tulis Kode Function link

Gunakan editor kode Monaco bawaan untuk menulis function Anda:

Editor menyediakan:

• ✅ Syntax highlighting
• ✅ Auto-completion
• ✅ Deteksi error
• ✅ Format kode
• ✅ Pengeditan multi-baris

Template Kode Default link

Saat Anda memilih runtime, kode default disediakan:

Template Python link

  # index.py  (Python 3.11)
def handler(event):
    try:
        a = float(event.get("key1"))
        b = float(event.get("key2"))
    except Exception:
        return {
            "statusCode": 400,
            "headers": {"content-type": "application/json"},
            "body": '{"error":"key1 and key2 must be numbers"}',
        }

    return {
        "statusCode": 200,
        "headers": {"content-type": "application/json"},
        "body": '{"result": %s}' % (a + b),
    }
  

Template JavaScript link

  // index.js (JavaScript)
export async function handler(event) {
  const a = Number(event?.key1);
  const b = Number(event?.key2);

  if (!Number.isFinite(a) || !Number.isFinite(b)) {
    return {
      statusCode: 400,
      headers: { "content-type": "application/json" },
      body: JSON.stringify({ error: "key1 and key2 must be numbers" }),
    };
  }

  return {
    statusCode: 200,
    headers: { "content-type": "application/json" },
    body: JSON.stringify({ result: a + b }),
  };
}
  

Template TypeScript link

  // index.ts (TypeScript)
interface Event {
  key1?: number | string;
  key2?: number | string;
}

export async function handler(event: Event) {
  const a = Number(event?.key1);
  const b = Number(event?.key2);

  if (!Number.isFinite(a) || !Number.isFinite(b)) {
    return {
      statusCode: 400,
      headers: { "content-type": "application/json" },
      body: JSON.stringify({ error: "key1 and key2 must be numbers" }),
    };
  }

  return {
    statusCode: 200,
    headers: { "content-type": "application/json" },
    body: JSON.stringify({ result: a + b }),
  };
}
  

Tanda Tangan Function link

Semua function menerima parameter event dengan payload permintaan:

Python:

  def handler(event):
    # event adalah dict dengan payload JSON
    name = event.get("name")
    return {"statusCode": 200, "body": "..."}
  

JavaScript/TypeScript:

  export async function handler(event) {
  // event adalah objek dengan payload JSON
  const name = event?.name;
  return { statusCode: 200, body: "..." };
}
  

Format Respons link

Function harus mengembalikan objek dengan:

  {
  "statusCode": 200,                          // HTTP status code
  "headers": {                                // Header opsional
    "content-type": "application/json"
  },
  "body": "{\"message\": \"Hello World\"}"   // Body respons (string)
}
  

Penting: Field body harus berupa string, bukan objek. Gunakan JSON.stringify() atau format string.

Langkah 4: Konfigurasi Resource link

Konfigurasi CPU, memory, dan timeout untuk function Anda:

vCPU (Virtual CPU) link

Pilih core CPU (1-32):

Default: 1 vCPU

Tips: Mulai dengan 1 vCPU dan tingkatkan jika ada masalah performa.

Memory (MB) link

Alokasikan memory (128-3072 MB):

Default: 512 MB

Penting: Lebih banyak memory = biaya per invokasi lebih tinggi.

Timeout (detik) link

Tetapkan waktu eksekusi maksimum (1-300 detik):

Default: 30 detik

Catatan: Function otomatis dihentikan jika melampaui timeout.

Langkah 5: Tes Function Anda link

1. Tulis Event Tes link

Masukkan payload JSON di editor event tes:

Contoh payload:

  {
  "key1": 10,
  "key2": 5
}
  

  {
  "name": "Alice",
  "age": 30,
  "city": "Jakarta"
}
  

2. Jalankan Tes link

Klik tombol Run Test:

Function akan dieksekusi secara lokal dan menampilkan hasil:

Output Tes Menampilkan:

• ✅ Respons - Nilai kembalian function
• ✅ Log - Output konsol dan error
• ✅ Waktu Eksekusi - Berapa lama proses berlangsung
• ✅ Status - Berhasil atau error

3. Verifikasi Output link

Cek output tes:

  {
  "statusCode": 200,
  "headers": {
    "content-type": "application/json"
  },
  "body": "{\"result\": 15}"
}
  

Jika ada error:

• Tinjau pesan error di log
• Perbaiki kode Anda
• Jalankan tes lagi

Tips: Tes dengan beberapa payload untuk mencakup berbagai skenario.

Langkah 6: Deploy Function link

Saat function Anda berfungsi dengan benar, deploy:

Klik Save/Deploy link

Klik tombol Save di sudut kanan atas.

Proses Deployment link

Sistem akan:

1. ✓ Validasi kode dan konfigurasi function
2. ✓ Buat microVM untuk function
3. ✓ Deploy runtime dan dependensi
4. ✓ Jalankan layanan function
5. ✓ Tandai function sebagai “Ready”

Waktu: Biasanya selesai dalam 2-5 detik

Notifikasi Berhasil link

Anda akan melihat pesan berhasil:

“Function created - [function-name] successfully created.”

Anda akan diarahkan ke halaman daftar Functions.

Langkah 7: Verifikasi Deployment link

Setelah deployment, verifikasi function siap:

Cek Tabel Function link

Di halaman daftar Functions, temukan function Anda:

• State harus “Ready” (badge hijau)
• Language menampilkan runtime yang dipilih
• Guest IP menampilkan alamat IP function
• Owner menampilkan “You”

Tes Invoke link

Klik tombol Invoke (ikon ▶ Play) untuk tes:

Masukkan payload tes dan klik Invoke:

Verifikasi respons sesuai harapan Anda.

Contoh Lengkap: Hello World API link

Mari buat function lengkap dari awal:

Konfigurasi link

• Name: hello-api
• Runtime: TypeScript
• Handler: handler
• vCPU: 1
• Memory: 512 MB
• Timeout: 30 dtk

Kode link

  interface Event {
  name?: string;
  language?: string;
}

export async function handler(event: Event) {
  const name = event?.name || "World";
  const language = event?.language || "en";

  const greetings: Record<string, string> = {
    en: "Hello",
    es: "Hola",
    fr: "Bonjour",
    id: "Halo",
    ja: "こんにちは",
  };

  const greeting = greetings[language] || greetings.en;

  return {
    statusCode: 200,
    headers: { "content-type": "application/json" },
    body: JSON.stringify({
      message: `${greeting}, ${name}!`,
      timestamp: new Date().toISOString(),
    }),
  };
}
  

Event Tes link

  {
  "name": "Alice",
  "language": "id"
}
  

Respons yang Diharapkan link

  {
  "statusCode": 200,
  "headers": {
    "content-type": "application/json"
  },
  "body": "{\"message\":\"Halo, Alice!\",\"timestamp\":\"2025-12-18T10:30:00.000Z\"}"
}
  

Coba: Buat function ini dan tes dengan berbagai bahasa!

Import dari Playground link

Jika Anda sudah bereksperimen di Playground, Anda dapat mengimpor pekerjaan Anda:

Langkah:

1. Kerjakan function di Playground terlebih dahulu
2. Klik “Save to Functions” di Playground
3. Halaman New Function terbuka dengan kode Anda sudah terisi
4. Konfigurasi nama dan resource
5. Klik Save untuk deploy

Manfaat: Iterasi cepat di Playground, lalu deploy saat siap.

Pemecahan Masalah link

Masalah: Function Tertahan di “Creating” link

Gejala:

• Status menampilkan “Creating” lebih dari 30 detik
• Tidak pernah berubah menjadi “Ready”

Solusi:

1. Refresh halaman - Terkadang UI perlu diperbarui
2. Cek resource host:
   • Buka halaman Hosts
   • Pastikan agent online
   • Cek CPU dan memory yang tersedia
3. Hapus dan buat ulang:
   • Hapus function yang tertahan
   • Buat yang baru

Masalah: Tes Gagal dengan Error link

Gejala:

• Output tes menampilkan pesan error
• Function tidak mengembalikan respons yang diharapkan

Solusi:

1. Cek log error di output tes:

     Error: name is undefined
     

2. Error umum:

   • Syntax error: Perbaiki sintaks kode
   • Variabel tidak terdefinisi: Periksa nama variabel
   • JSON parse error: Pastikan body adalah string
   • Timeout: Kurangi waktu pemrosesan atau tingkatkan timeout

3. Tips debug:

   • Tambahkan pernyataan console.log() (Python: print())
   • Tes dengan payload sederhana terlebih dahulu
   • Pastikan struktur event sesuai kode Anda

Contoh perbaikan:

  // ❌ Salah - body adalah objek
return {
  statusCode: 200,
  body: { message: "Hi" }  // ERROR!
};

// ✅ Benar - body adalah string
return {
  statusCode: 200,
  body: JSON.stringify({ message: "Hi" })
};
  

Masalah: Tidak Dapat Menyimpan Function link

Gejala:

• Tombol Save dinonaktifkan
• Error validasi ditampilkan

Solusi:

1. Periksa kolom yang diperlukan:

   • ✅ Nama terisi
   • ✅ Runtime dipilih
   • ✅ Handler terisi
   • ✅ Kode tidak kosong

2. Perbaiki error validasi:

   • Teks merah menampilkan apa yang salah
   • Perbaiki setiap error sebelum menyimpan

3. Kode harus valid:

   • Tidak ada syntax error
   • Function handler ada
   • Struktur yang benar

Praktik Terbaik link

Organisasi Kode link

✅ Jaga function terfokus:

  // ✅ Baik - Tanggung jawab tunggal
export async function handler(event) {
  return processPayment(event);
}

// ❌ Buruk - Terlalu banyak tanggung jawab
export async function handler(event) {
  // 100 baris logika yang bercampur...
}
  

Penanganan Error link

✅ Selalu tangani error:

  def handler(event):
    try:
        # Logika Anda di sini
        result = process_data(event)
        return {
            "statusCode": 200,
            "body": json.dumps({"result": result})
        }
    except ValueError as e:
        return {
            "statusCode": 400,
            "body": json.dumps({"error": str(e)})
        }
    except Exception as e:
        return {
            "statusCode": 500,
            "body": json.dumps({"error": "Internal server error"})
        }
  

Alokasi Resource link

✅ Sesuaikan ukuran function Anda:

• Mulai dengan resource minimum (1 vCPU, 512 MB)
• Monitor waktu invokasi di log
• Tingkatkan hanya jika diperlukan
• Jangan over-alokasi (biaya lebih tinggi)

Pengujian link

✅ Tes secara menyeluruh sebelum deploy:

• Tes dengan input valid
• Tes dengan input tidak valid
• Tes edge case
• Tes skenario error

Langkah Selanjutnya link

Setelah membuat function:

• Kelola Functions - Invoke, perbarui, dan hapus function
• Lihat Log - Debug dan monitor eksekusi function
• Playground - Bereksperimen dengan ide baru

Referensi Cepat link

Struktur Function link

Python:

  def handler(event):
    # Proses event (dict)
    return {
        "statusCode": 200,
        "headers": {"content-type": "application/json"},
        "body": json.dumps({"result": "..."})
    }
  

TypeScript:

  export async function handler(event) {
  // Proses event (objek)
  return {
    statusCode: 200,
    headers: { "content-type": "application/json" },
    body: JSON.stringify({ result: "..." }),
  };
}
  

Batas Resource link

HTTP Status Code Umum link