Node ve OCI konteyneri

Uyumluluk: Node 22.14+ ve 24.x üzerinde Pactmark 0.2.x. Referans OCI imajı yerelde derlenebilirdir; ne yayımlanmıştır ne de üretim için sertifikalıdır.

HTTP köprüsü

@pactmark/node, Web standardı bir işleyiciyi node:http’ye köprüler, yanıtları tamponlamadan akıtır ve istemci kopmalarını bir AbortSignal olarak yayar.

server.ts

import {
  createPactmarkNodeServer,
  installGracefulShutdown,
} from "@pactmark/node";
import { createAgentFetchHandler } from "@pactmark/http";

const handler = createAgentFetchHandler({
  basePath: "/v1",
  runtime,
  authenticate: async (request) => resolvePrincipalAndTenant(request),
});

const server = createPactmarkNodeServer(handler, {
  publicOrigin: process.env.PUBLIC_ORIGIN,
  readEnvironment: () => ({ PACTMARK_PROFILE: process.env.PACTMARK_PROFILE }),
  capabilities: runtime.getCapabilities(),
});

installGracefulShutdown(server, { signal: "SIGTERM", timeoutMs: 30_000 });

server.listen(8080);

installGracefulShutdown bir kaldırıcı döndürür. SIGTERM alındığında yeni bağlantı kabul etmeyi bırakır, devam eden isteklere timeoutMs kadar süre tanır ve kalan bağlantıları kapatır. Koşu gerçeği depoda olduğu için kapanan bir bağlantı kayıp iş anlamına gelmez.

Sağlık ve hazırlık

curl -fsS http://localhost:8080/healthz   # süreç canlı
curl -fsS http://localhost:8080/readyz    # istenen profili karşılayabiliyor

readyz’i orkestratörünüzün readiness probe’una, healthz’i liveness’a bağlayın. Hazırlığı liveness’a bağlamayın — dürüstçe hazır-değil bildiren bir çalışma zamanı öldürülüp aynı duruma yeniden başlatılmak yerine rotasyondan çıkarılmalıdır.

Worker’ı ayrı çalıştırma

Şekil 1. Worker, farklı yaşam döngüsü olan farklı bir süreçtir. “Farklı süreç”i güvenli kılan şey fenced kiralardır.

worker.ts

import { createPostgresWorkerDriver } from "@pactmark/driver-postgres-worker";

const worker = createPostgresWorkerDriver({
  pool,
  leaseDurationMs: 30_000,
  claimBatchSize: 8,
});

await worker.run({ signal: shutdownController.signal });

Worker döngüsünü “şimdilik” HTTP sürecinizin içinde çalıştırmayın. Web katmanını ölçeklediğiniz anda, hiç düşünmeden N tane yarışan worker’ınız olur — fenced kiralar bunu doğru şekilde ele alır ama veritabanı yükünüz almaz.

Referans konteyner fixture’ı

OCI uygunluk fixture’ı, kasıtlı olarak düşmanca yapılandırılmış bir test artefaktıdır:

Kontrol	Ayar
Kullanıcı	Root olmayan
Ağ	Derleme sırasında kapalı
Kök dosya sistemi	Salt okunur
Çalışma alanı	tmpfs
Bağlamalar ve Docker soketi	Yok
Yetenekler	Düşürülmüş
Ayrıcalık yükseltme	`no-new-privileges`
Sınırlar	Süreç, bellek, CPU, süre ve çıktı sınırları

Traversal, symlink, sır, soket, loopback, metadata, fork, döngü ve çıktı sondalarını çalıştırır.

Bu kontroller çekirdek, çalışma zamanı, konteyner motoru, yan kanal veya çok kiracılı saldırılara karşı direnci kanıtlamaz. Fixture üretimde rastgele kod izolasyonu değildir — bkz. Sandbox sınırı.

Dağıtım biçimi

docker-compose.yml

services:
  api:
    image: your-registry/pactmark-api:1.0.0
    environment:
      PACTMARK_PROFILE: production
      DATABASE_URL: postgres://app@db:5432/pactmark?sslmode=verify-full
    read_only: true
    user: "10001:10001"
    cap_drop: ["ALL"]
    security_opt: ["no-new-privileges:true"]
    healthcheck:
      test: ["CMD", "curl", "-fsS", "http://localhost:8080/readyz"]

  worker:
    image: your-registry/pactmark-worker:1.0.0
    environment:
      PACTMARK_PROFILE: production
      DATABASE_URL: postgres://app@db:5432/pactmark?sslmode=verify-full
    read_only: true
    user: "10001:10001"
    cap_drop: ["ALL"]
    security_opt: ["no-new-privileges:true"]

API ve worker bir veritabanını paylaşır, başka hiçbir şeyi paylaşmaz. Amaç da budur.

Sonlanma ve kurtarma

İş kabul etmeyi bırakın

Hazırlık false olur; yük dengeleyici boşaltır.

Kiraları bırakın veya süresinin dolmasına izin verin

Kapanışta temizce bırakın ya da süresi dolsun. Fencing sayesinde ikisi de güvenlidir.

Kalıcı olaylardan devam edin

Sonraki bir süreç depodan yeniden kurar. Hiçbir şey eski sürecin belleğine bağlı değildir.

Belirsiz bir etkiyi asla tekrarlamayın

Kayıtlı stratejisi yeniden denemenin güvenli olduğunu kanıtlamadıkça. Bir süreci yeniden başlatmak, dış sistem hakkında yeni bir bilgi değildir.

PostgreSQL profili

Göçler, TLS, korumalı bağlam ve yedekler.

Güvenilirlik ve kurtarma

RPO/RTO ve park edilmiş işlerin izlenmesi.

Başlarken

Temel kavramlar

Rehberler

Dağıtım

Üretim

Güvenlik

Node ve OCI konteyneri

HTTP köprüsü

Sağlık ve hazırlık

Worker’ı ayrı çalıştırma

Referans konteyner fixture’ı

Dağıtım biçimi

Sonlanma ve kurtarma

PostgreSQL profili

Güvenilirlik ve kurtarma

​HTTP köprüsü

​Sağlık ve hazırlık

​Worker’ı ayrı çalıştırma

​Referans konteyner fixture’ı

​Dağıtım biçimi

​Sonlanma ve kurtarma

PostgreSQL profili

Güvenilirlik ve kurtarma

HTTP köprüsü

Sağlık ve hazırlık

Worker’ı ayrı çalıştırma

Referans konteyner fixture’ı

Dağıtım biçimi

Sonlanma ve kurtarma