Belajar Floci - Integrasi CI/CD Pipeline

#Pendahuluan

CI adalah tempat emulator lokal memberikan ROI paling terukur: pipeline berjalan puluhan kali sehari, dan setiap menit yang dihemat dikalikan ribuan run per bulan. Dua angka kunci Floci bekerja untuk kalian di sini — startup milidetik (bukan detik) dan image ~90 MB (bukan ~1 GB) yang mempercepat pull di runner.

Episode ini membahas integrasi di dua platform utama plus disiplin yang menjaga pipeline tetap stabil dalam jangka panjang.

#Pipeline

#GitHub Actions — Service Container

name: ci
on: [push]
jobs:
  test:
    runs-on: ubuntu-latest
    services:
      floci:
        image: floci/floci:1.5.15 # pinned - bukan latest
        ports:
          - 4566:4566
        options: >-
          --health-cmd "curl -sf http://localhost:4566/_floci/health"
          --health-interval 2s
          --health-timeout 3s
          --health-retries 10
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with: { python-version: "3.12" }
      - run: pip install -r requirements.txt boto3 pytest
      - name: Integration tests
        env:
          AWS_ENDPOINT_URL: http://localhost:4566
          AWS_ACCESS_KEY_ID: ci-dummy
          AWS_SECRET_ACCESS_KEY: ci-dummy
        run: pytest tests/ -m integration

Service container menyala sebelum step pertama dengan health check — dan karena startup floci hanya ~24 ms, biaya "menunggu service siap" praktis nol. Bandingkan dengan menyalakan emulator lain yang bisa makan 10–30 detik per job.

#GitLab CI — Service Definition

integration-test:
  stage: test
  image: python:3.12
  services:
    - name: floci/floci:1.5.15
      alias: floci            # hostname akses dari job
  variables:
    AWS_ENDPOINT_URL: http://floci:4566
  script:
    - pip install -r requirements.txt pytest boto3
    - pytest tests/ -m integration

Alias floci membuat endpoint konsisten antar platform — script test tidak peduli di mana ia dijalankan.

#Disiplin

#Pin Versi, Cache Layer, Parallel Job Isolation

Parallel isolation butuh perhatian khusus: dua job pada runner sama TIDAK boleh berbagi satu instance floci — gunakan service container per-job (GitHub Actions otomatis) atau compose project name unik.

#Praktik

Target outline: tambahkan job e2e berbasis floci pada repo contoh.

Struktur repo + marker pytesttests/test_e2e.py - alur lengkapJob matrix paralel

# repo/
# ├── app/
# │   └── order_service.py
# ├── tests/
# │   ├── conftest.py      # fixture floci (ep.20)
# │   ├── test_unit.py     # marker unit
# │   └── test_e2e.py      # marker e2e
# └── .github/workflows/ci.yml

import pytest, boto3
 
pytestmark = pytest.mark.e2e
 
def test_full_order_flow(aws):
    ddb = aws["ddb"]
    ddb.create_table(TableName="orders", BillingMode="PAY_PER_REQUEST",
        AttributeDefinitions=[{"AttributeName": "pk", "AttributeType": "S"}],
        KeySchema=[{"AttributeName": "pk", "KeyType": "HASH"}]).wait_until_exists()
    sqs = aws["sqs"].create_queue(QueueName="fulfillment")
 
    from app.order_service import place_order
    place_order(ddb.Table("orders"), aws["sqs"], "ORD-E1", amount=150000)
 
    assert ddb.Table("orders").get_item(Key={"pk": "ORD-E1"})["Item"]["status"] == "placed"
    msgs = aws["sqs"].receive_message(QueueUrl=sqs["QueueUrl"]).get("Messages", [])
    assert msgs and '"ORD-E1"' in msgs[0]["Body"]

jobs:
  unit:   { steps: [...], }   # tanpa service - instan
  e2e:
    services: { floci: { image: floci/floci:1.5.15, ... } }
    steps:
      - run: pytest tests/ -m "unit or e2e"

Ukur dampaknya: bandingkan durasi workflow sebelum/sesudah — kombinasi pull 90 MB, startup 24 ms, dan storage memory biasanya memangkas menit-an per run dibanding emulator berat atau environment cloud.

#Penutup

Rangkuman episode ini:

• Service container GitHub Actions/GitLab + health check; startup & image kecil = feedback loop tercepat di kelasnya.
• Empat disiplin: pin versi, cache layer, isolasi parallel, storage memory di CI.
• Praktik: job e2e penuh (DynamoDB + SQS + service logic) tanpa satu pun credentials AWS.

Episode 22 adalah jawaban langsung atas krisis Maret 2026: migration playbook LocalStack → Floci — langkah swap, translasi env, verifikasi compat SDK, audit feature gates, dan gerbang re-run suite penuh. Sampai jumpa!