DevOps & Cloud

Edge Serverless: Deploy API ke Cloudflare Workers dengan Hono dalam 10 Menit

API yang berjalan dekat dengan pengguna, tanpa server untuk diurus. Bangun REST API dengan Hono, simpan data di D1, lalu deploy ke Cloudflare Workers.

NP
novan putra 20 Oktober 2026 · 4 mnt baca · 871 dilihat
Edge Serverless: Deploy API ke Cloudflare Workers dengan Hono dalam 10 Menit

Serverless generasi pertama memindahkan kode ke cloud; edge serverless memindahkannya ke ratusan lokasi di seluruh dunia, sedekat mungkin dengan pengguna. Untuk audiens Indonesia, itu berarti respons dari lokasi edge terdekat, bukan dari server di benua lain. Di penghujung 2026, kombinasi Cloudflare Workers + Hono menjadi salah satu cara paling populer untuk membangun API ringan.

Kenapa Hono?

Hono adalah web framework kecil dan cepat yang dibangun di atas Web Standards (Request, Response). Ia bisa berjalan di Cloudflare Workers, Deno, Bun, Node.js, dan lainnya — kode yang sama, runtime berbeda.

Request ke API di edge
Kode berjalan di lokasi terdekat pengguna, bukan di satu server pusat.

Membuat Project

npm create hono@latest api-blog
# pilih template: cloudflare-workers
cd api-blog
npm install
npm run dev   # jalan di http://localhost:8787

API Pertama

// src/index.ts
import { Hono } from 'hono';
import { cors } from 'hono/cors';

type Bindings = { DB: D1Database; API_TOKEN: string };

const app = new Hono<{ Bindings: Bindings }>();

app.use('/api/*', cors());

app.get('/', (c) => c.json({ pesan: 'Halo dari edge! 👋' }));

app.get('/api/artikel', async (c) => {
  const { results } = await c.env.DB
    .prepare('SELECT id, judul, slug, terbit FROM artikel ORDER BY terbit DESC LIMIT 20')
    .all();
  return c.json(results);
});

app.get('/api/artikel/:slug', async (c) => {
  const row = await c.env.DB
    .prepare('SELECT * FROM artikel WHERE slug = ?')
    .bind(c.req.param('slug'))
    .first();
  return row ? c.json(row) : c.json({ error: 'Tidak ditemukan' }, 404);
});

export default app;

Database D1 (SQLite di Edge)

npx wrangler d1 create blog-db

Salin database_id yang muncul ke konfigurasi:

# wrangler.toml
name = "api-blog"
main = "src/index.ts"
compatibility_date = "2026-10-01"

[[d1_databases]]
binding = "DB"
database_name = "blog-db"
database_id = "xxxx-xxxx-xxxx"
-- schema.sql
CREATE TABLE IF NOT EXISTS artikel (
  id     INTEGER PRIMARY KEY AUTOINCREMENT,
  judul  TEXT NOT NULL,
  slug   TEXT NOT NULL UNIQUE,
  isi    TEXT NOT NULL,
  terbit TEXT NOT NULL DEFAULT (datetime('now'))
);
INSERT INTO artikel (judul, slug, isi) VALUES
  ('Halo Edge', 'halo-edge', 'Artikel pertama dari D1.');
npx wrangler d1 execute blog-db --local  --file=schema.sql
npx wrangler d1 execute blog-db --remote --file=schema.sql

Endpoint Tulis dengan Validasi & Autentikasi

import { bearerAuth } from 'hono/bearer-auth';
import { zValidator } from '@hono/zod-validator';
import { z } from 'zod';

const skemaArtikel = z.object({
  judul: z.string().min(3).max(200),
  slug: z.string().regex(/^[a-z0-9-]+$/),
  isi: z.string().min(10),
});

app.post(
  '/api/artikel',
  (c, next) => bearerAuth({ token: c.env.API_TOKEN })(c, next),
  zValidator('json', skemaArtikel),
  async (c) => {
    const a = c.req.valid('json');
    await c.env.DB
      .prepare('INSERT INTO artikel (judul, slug, isi) VALUES (?, ?, ?)')
      .bind(a.judul, a.slug, a.isi)
      .run();
    return c.json({ ok: true }, 201);
  },
);
npm install zod @hono/zod-validator
npx wrangler secret put API_TOKEN   # simpan token sebagai secret, bukan di kode

Deploy

npx wrangler deploy
# ✨ https://api-blog.<akun-kamu>.workers.dev

curl https://api-blog.<akun-kamu>.workers.dev/api/artikel

Selesai — API kamu sudah tersebar di jaringan global Cloudflare.

Hal yang Perlu Diperhatikan

Topik Catatan
Batas CPU Worker cocok untuk kerja singkat; tugas berat pindahkan ke queue / server biasa
Node API Banyak modul Node didukung lewat flag nodejs_compat, tapi tidak semua
Database D1 cocok untuk data ringan; untuk MySQL/Postgres yang sudah ada, gunakan Hyperdrive
Biaya Tier gratis cukup besar untuk project pribadi dan eksperimen

Menggabungkan dengan Blog di Hostinger

Pola yang menarik: blog PHP tetap di Hostinger, sementara fitur yang butuh latensi rendah — misalnya API pencarian, penghitung view, atau webhook — dipindahkan ke Worker. Keduanya bisa hidup berdampingan dengan subdomain seperti api.novanputra.blog.

Penutup

Edge serverless menurunkan hambatan untuk membuat API global: tanpa server, tanpa konfigurasi rumit, dan biaya awal mendekati nol. Coba pindahkan satu endpoint kecil ke Worker minggu ini, ukur latensinya dari Indonesia, dan rasakan bedanya.

NP
Ditulis oleh

novan putra

Penulis utama blog ini.

0 Komentar

Komentar ditinjau dulu sebelum tampil.