참고소스 수정본

참고/firecrawl-main/examples/kubernetes/firecrawl-helm/README.md

@@ -0,0 +1,120 @@
+# Firecrawl Helm Chart
+
+This chart deploys Firecrawl on Kubernetes with:
+- `api`
+- `worker` (queue-worker)
+- `extract-worker`
+- `nuq-worker`
+- `nuq-prefetch-worker`
+- `playwright-service`
+- `redis`
+- `nuq-postgres`
+- `rabbitmq`
+
+## Image Strategy
+
+- **x86-only cluster**: use official Firecrawl images from GHCR (`ghcr.io/firecrawl/...`).
+- **ARM or mixed ARM+x86 cluster**: use your multi-arch `winkkgmbh` images.
+
+Official Firecrawl images are fine for x86. Use winkk images only when ARM support is needed.
+
+## Configure Values
+
+Use `values.yaml` plus one overlay.
+
+Important fields:
+- `secret.*` for API keys and sensitive values.
+- `config.extra` / `secret.extra` for custom env vars.
+- `image.dockerSecretEnabled` and `imagePullSecrets` for private registries.
+- `resources.enabled` enables/disables all container resource requests/limits.
+  Default: `false`.
+- `rabbitmq.enabled`, `extractWorker.enabled`, `nuqPrefetchWorker.enabled` to toggle components.
+
+## Deploy
+
+Render:
+
+```bash
+HELM_NO_PLUGINS=1 helm template firecrawl . \
+  -f values.yaml \
+  -f overlays/prod/values.yaml \
+  -n firecrawl
+```
+
+Install/upgrade:
+
+```bash
+HELM_NO_PLUGINS=1 helm upgrade firecrawl . \
+  -f values.yaml \
+  -f overlays/prod/values.yaml \
+  -n firecrawl \
+  --install \
+  --create-namespace
+```
+
+### Use Official Firecrawl Images (x86-only)
+
+If your cluster is x86-only and you want official images, override repositories:
+
+```bash
+HELM_NO_PLUGINS=1 helm upgrade firecrawl . \
+  -f values.yaml \
+  -f overlays/prod/values.yaml \
+  --set image.repository=ghcr.io/firecrawl/firecrawl \
+  --set playwright.repository=ghcr.io/firecrawl/playwright-service \
+  --set nuqPostgres.image.repository=ghcr.io/firecrawl/nuq-postgres \
+  -n firecrawl \
+  --install \
+  --create-namespace
+```
+
+## Build and Push Multi-Arch Containers (ARM+x86)
+
+Run from `examples/kubernetes/firecrawl-helm`:
+
+```bash
+docker buildx create --name multiarch --use --bootstrap
+```
+
+```bash
+docker buildx build --platform linux/amd64,linux/arm64 --push \
+  -t docker.io/winkkgmbh/firecrawl:latest \
+  ../../../apps/api
+
+docker buildx build --platform linux/amd64,linux/arm64 --push \
+  -t docker.io/winkkgmbh/firecrawl-playwright:latest \
+  ../../../apps/playwright-service-ts
+
+docker buildx build --platform linux/amd64,linux/arm64 --push \
+  -t docker.io/winkkgmbh/nuq-postgres:latest \
+  ../../../apps/nuq-postgres
+```
+
+## Package and Push Helm Chart (OCI)
+
+```bash
+HELM_NO_PLUGINS=1 helm package . --destination /tmp/helm-packages
+HELM_NO_PLUGINS=1 helm push /tmp/helm-packages/firecrawl-0.2.0.tgz oci://registry-1.docker.io/winkkgmbh
+```
+
+Install from OCI:
+
+```bash
+HELM_NO_PLUGINS=1 helm upgrade --install firecrawl oci://registry-1.docker.io/winkkgmbh/firecrawl \
+  --version 0.2.0 \
+  -n firecrawl --create-namespace \
+  -f values.yaml \
+  -f overlays/prod/values.yaml
+```
+
+## Test
+
+```bash
+kubectl port-forward svc/firecrawl-firecrawl-api 3002:3002 -n firecrawl
+```
+
+## Cleanup
+
+```bash
+helm uninstall firecrawl -n firecrawl
+```