AlurKerja Released - 2026.05.3.1

✨ New Features

Experiment Safely in Test Environments

Fitur ini dapat digunakan bereksperimen dengan alur BPMN dan konfigurasi integrasi secara aman di lingkungan Test sebelum di-deploy ke Live/Production.

• Multi-environment per workspace (Test & Live)
  
• Switch environment langsung dari App
  
• Konfigurasi integrasi terpisah per environment (Test/Live)

Template Repository: Empowering External Contributor

Fitur ini digunakan sebagai repositori template proses bisnis yang bisa dikontribusikan oleh pengguna eksternal tertentu untuk memperkaya ekosistem AlurKerja dengan template dari berbagai industri.

• Submit BPMN sebagai template dari BPMN Editor
  
• Monitoring & manajemen submission di Studio: list, detail, edit, hapus
• Use This Template mendukung deployment type & setup integrasi
  

Scalable & Centralized License Management

• Sistem lisensi terpusat: on-premise registrasi otomatis ke SaaS
• Dashboard lisensi untuk owner
  

🔧 Enhancements

Pada release kali ini mencakup berbagai perbaikan lintas fitur, peningkatan keamanan, dan beberapa enhancement UX.

Secure Access for Backend Endpoints

• Role-based authorization diterapkan di seluruh service backend
• Security patch: update library semua service (high & medium severity)

UX & Editor

• Semua textarea diupgrade ke rich text area
• My Task dapat difilter berdasarkan variable proses

🐛 Bug Fixes

• Rich text area: teks tidak lagi kebalik/acak saat pertama mengetik
• Chat input area tidak hilang saat melampirkan banyak file
• Knowledge Base: kolom content dapat di-scroll saat konten panjang
• Knowledge Base: tautan pada field content dapat dibuka di mode preview
• Perbaikan Blank page/error saat data company information belum tersedia
• Perbaikan overlapping widget Chat & Live Chat di tampilan mobile

Upgrade Guide AlurKerja Release 202505.3.1

Panduan ini ditujukan untuk user on-premise yang ingin melakukan upgrade dari versi sebelumnya ke 202605.3.1

1. Breaking Changes & Deprecations

🔴 Breaking: Tabel Baru tenant_environment_mapping

Terdapat table baru di schema public yang wajib dibuat sebelum service dijalankan.

CREATE TABLE public.tenant_environment_mapping (
  id bigserial NOT NULL,
  tenant_id int8 NOT NULL,
  tenant_uuid varchar(255) NOT NULL,
  tenant_slug varchar(255) NOT NULL,
  environment varchar(255) NOT NULL,
  is_production bool DEFAULT false NULL,
  camunda_tenant_uuid varchar(255) NOT NULL,
  CONSTRAINT tenant_environment_mapping_pkey PRIMARY KEY (id)
);

CREATE INDEX idx_tenant_environment_mapping_tenant_id
  ON public.tenant_environment_mapping USING btree (tenant_id);

ALTER TABLE public.tenant_environment_mapping
  ADD CONSTRAINT fk_tenant_environment_mapping_tenant
  FOREIGN KEY (tenant_id) REFERENCES public.tenants(id);

Jika tabel ini tidak dibuat, service onprem-tenant akan gagal start.

🔴 Breaking: Seed Environments Wajib Dijalankan

Setelah migrasi database, data environments harus di-seed ulang. Tanpa ini, tenant tidak bisa diidentifikasi environment-nya (LIVE/TEST).

🟡 Deprecation: Tidak Ada

Tidak ada API, env var, atau fitur yang di-deprecate di rilis ini.

2. Prasyarat Sebelum Upgrade

Checklist prasyarat:

• Dapat akses ke container registry AlurKerja
• Koneksi database PostgreSQL bisa dijangkau dari host
• Service onprem-tenant bisa exec untuk seed

3. Backup Checklist

Lakukan seluruh backup ini sebelum memulai upgrade:

• PostgreSQL — schema public: pg_dump -n public -Fc alurkerja_db > backup_public_$(date +%Y%m%d).dump
• PostgreSQL — schema camunda: pg_dump -n camunda -Fc alurkerja_db > backup_camunda_$(date +%Y%m%d).dump
• MinIO / S3: Snapshot bucket atau sync ke storage lain
• File .env / docker-compose.yml: Copy ke lokasi aman
• Kubernetes Secrets & ConfigMaps: kubectl get secret -o yaml > secrets_backup.yaml
• Volume snapshot (jika menggunakan persistent volume di Kubernetes)

4. Langkah Upgrade

4a. Docker Compose

# 1. Pull image terbaru
docker compose pull

# 2. Stop service (jangan hapus volume)
docker compose down

# 3. Jalankan migrasi database (lihat Bagian 5)
# -- Lakukan manual sebelum start --

# 4. Start seluruh service
docker compose up -d

# 5. Cek status
docker compose ps
docker compose logs -f onprem-tenant

4b. Kubernetes

# 1. Update image tag di manifest / values.yaml ke tag release terbaru
# (sesuaikan dengan image tag yang tertera di release notes)

# 2. Apply perubahan
kubectl apply -f ./manifests/
# atau jika menggunakan Helm:
helm upgrade alurkerja ./chart --namespace alurkerja

# 3. Monitor rollout
kubectl rollout status deployment/onprem-tenant -n alurkerja
kubectl get pods -n alurkerja

# 4. Jalankan seed environments (lihat Bagian 5)

5. Migrasi Database

Migrasi tidak berjalan otomatis. Ikuti urutan berikut:

Langkah 1 — Buat tabel baru

Jalankan DDL berikut di database PostgreSQL (schema public):

-- Buat tabel tenant_environment_mapping
CREATE TABLE public.tenant_environment_mapping (
  id bigserial NOT NULL,
  tenant_id int8 NOT NULL,
  tenant_uuid varchar(255) NOT NULL,
  tenant_slug varchar(255) NOT NULL,
  environment varchar(255) NOT NULL,
  is_production bool DEFAULT false NULL,
  camunda_tenant_uuid varchar(255) NOT NULL,
  CONSTRAINT tenant_environment_mapping_pkey PRIMARY KEY (id)
);

CREATE INDEX idx_tenant_environment_mapping_tenant_id
  ON public.tenant_environment_mapping USING btree (tenant_id);

ALTER TABLE public.tenant_environment_mapping
  ADD CONSTRAINT fk_tenant_environment_mapping_tenant
  FOREIGN KEY (tenant_id) REFERENCES public.tenants(id);

Langkah 2 — Seed environments

Docker Compose:

docker compose exec -it onprem-tenant ash ./seed_environments

Kubernetes:

# Masuk ke pod onprem-tenant
kubectl exec -it deployment/onprem-tenant -n alurkerja -- ash ./seed_environments

# Verifikasi hasil seed
kubectl exec -it deployment/onprem-tenant -n alurkerja -- \
  psql $DATABASE_URL -c "SELECT COUNT(*) FROM tenant_environment_mapping;"

Hasil yang diharapkan: seed selesai dengan output seeded: 942, skipped: 0 (angka sesuai jumlah tenant aktif).

6. Perubahan Konfigurasi

Tidak ada perubahan konfigurasi env

7. Post-Upgrade Verification

Jalankan checklist ini setelah upgrade selesai:

• Versi service: Cek via docker compose ps atau kubectl get pods — semua pod Running
• Tabel tersedia: SELECT COUNT(*) FROM tenant_environment_mapping; mengembalikan angka > 0
• Smoke test login: Login dengan akun tenant LIVE berhasil
• Smoke test environment: Tenant dapat membedakan environment LIVE vs TEST
• Cek log error: docker compose logs --tail=100 onprem-tenant — tidak ada FATAL/PANIC
• Camunda: Proses Camunda bisa dijalankan dari tenant LIVE

8. Rollback Procedure

Jika upgrade gagal, ikuti langkah berikut:

# 1. Stop service yang baru
docker compose down
# atau: kubectl rollout undo deployment/onprem-tenant -n alurkerja

# 2. Restore database PostgreSQL
pg_restore -n public -d alurkerja_db backup_public_YYYYMMDD.dump
pg_restore -n camunda -d alurkerja_db backup_camunda_YYYYMMDD.dump

# 3. Kembalikan image ke versi sebelumnya
# Edit docker-compose.yml ke tag versi lama, lalu:
docker compose pull
docker compose up -d

⚠️ Penting: Tabel tenant_environment_mapping yang sudah dibuat bisa dibiarkan — tidak akan merusak versi sebelumnya. Namun jika ingin bersih, jalankan DROP TABLE public.tenant_environment_mapping;.

9. Known Issues & Troubleshooting

1. seed_environments gagal dengan error foreign key

Penyebab: Ada tenant di tabel tenants yang data-nya tidak konsisten.
Solusi: Cek tenant bermasalah dengan query:

SELECT t.id FROM tenants t
LEFT JOIN tenant_environment_mapping m ON m.tenant_id = t.id
WHERE m.id IS NULL;

2. Pod onprem-tenant CrashLoopBackOff setelah upgrade

Penyebab paling umum: Tabel tenant_environment_mapping belum dibuat.
Solusi: Jalankan DDL di Bagian 5 terlebih dahulu, lalu restart pod.

3. Image pull gagal

Penyebab: Kredensial registry expired atau tidak ada akses.
Solusi: Login ulang ke registry:

docker login

Atau update imagePullSecret di Kubernetes.