## Context
Companion fix to 2026-04-19's service-upgrade spec refactor. The agent
pod has no Vault CLI auth (no VAULT_TOKEN, port 8200 refused), so every
`vault kv get` in the spec returned empty:
- `WOODPECKER_TOKEN=""` → 401 on /api/repos/1/pipelines → agent can't
find its pipeline → 15m poll timeout → rollback loop → >30m cap.
- `SLACK_WEBHOOK=""` → webhook POST to empty URL → no Slack messages
for 3+ days (the surface symptom that kicked off bd code-3o3).
## This change
Extends the `claude-agent-secrets` ExternalSecret with two more keys,
making them available to the agent via `envFrom`:
- `WOODPECKER_API_TOKEN` ← `secret/ci/global.woodpecker_api_token`
(already used by the vault-woodpecker-sync CronJob, same key)
- `SLACK_WEBHOOK_URL` ← `secret/viktor.alertmanager_slack_api_url`
(shared webhook also consumed by Alertmanager)
Pairs with commit a5963169 which refactored service-upgrade.md to read
these env vars directly instead of shelling out to `vault kv get`.
## What is NOT in this change
- REGISTRY_USER / REGISTRY_PASSWORD — not needed on the agent side.
The separate `.woodpecker/build-cli.yml` fix (bd code-3o3 fix C)
will add those to `secret/ci/global` for the vault-woodpecker-sync
CronJob to publish as Woodpecker secrets, not here.
## Test Plan
### Automated
`terraform plan` reported `Plan: 0 to add, 2 to change, 0 to destroy`
(ExternalSecret + a cosmetic `tier` label drop on the Deployment).
Applied cleanly.
### Manual Verification
```
$ kubectl -n claude-agent get externalsecret claude-agent-secrets \
-o jsonpath='{.status.conditions[?(@.type=="Ready")].message}'
secret synced
$ kubectl -n claude-agent exec deploy/claude-agent-service -- sh -c \
'echo "WP=${WOODPECKER_API_TOKEN:0:20}... SLACK=${SLACK_WEBHOOK_URL:0:40}..."'
WP=eyJhbGciOiJIUzI1NiIs... SLACK=https://hooks.slack.com/services/T02SV75...
$ kubectl -n claude-agent rollout status deploy/claude-agent-service
deployment "claude-agent-service" successfully rolled out
```
Next step: fire one synthetic DIUN webhook to confirm the agent reaches
Slack + lands a commit + exits cleanly, completing code-3o3.
Refs: bd code-3o3
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
616 lines
17 KiB
HCL
616 lines
17 KiB
HCL
data "vault_kv_secret_v2" "secrets" {
|
|
mount = "secret"
|
|
name = "claude-agent-service"
|
|
}
|
|
|
|
data "vault_kv_secret_v2" "viktor_secrets" {
|
|
mount = "secret"
|
|
name = "viktor"
|
|
}
|
|
|
|
locals {
|
|
namespace = "claude-agent"
|
|
image = "registry.viktorbarzin.me/claude-agent-service"
|
|
image_tag = "2fd7670d"
|
|
labels = {
|
|
app = "claude-agent-service"
|
|
}
|
|
}
|
|
|
|
# --- Namespace ---
|
|
|
|
resource "kubernetes_namespace" "claude_agent" {
|
|
metadata {
|
|
name = local.namespace
|
|
labels = {
|
|
tier = local.tiers.aux
|
|
"resource-governance/custom-limitrange" = "true"
|
|
"resource-governance/custom-quota" = "true"
|
|
}
|
|
}
|
|
lifecycle {
|
|
# KYVERNO_LIFECYCLE_V1: goldilocks-vpa-auto-mode ClusterPolicy stamps this label on every namespace
|
|
ignore_changes = [metadata[0].labels["goldilocks.fairwinds.com/vpa-update-mode"]]
|
|
}
|
|
}
|
|
|
|
# --- Secrets ---
|
|
|
|
resource "kubernetes_manifest" "external_secret" {
|
|
manifest = {
|
|
apiVersion = "external-secrets.io/v1beta1"
|
|
kind = "ExternalSecret"
|
|
metadata = {
|
|
name = "claude-agent-secrets"
|
|
namespace = local.namespace
|
|
}
|
|
spec = {
|
|
refreshInterval = "15m"
|
|
secretStoreRef = {
|
|
name = "vault-kv"
|
|
kind = "ClusterSecretStore"
|
|
}
|
|
target = {
|
|
name = "claude-agent-secrets"
|
|
}
|
|
data = [
|
|
{
|
|
secretKey = "GITHUB_TOKEN"
|
|
remoteRef = {
|
|
key = "viktor"
|
|
property = "github_pat"
|
|
}
|
|
},
|
|
{
|
|
secretKey = "API_BEARER_TOKEN"
|
|
remoteRef = {
|
|
key = "claude-agent-service"
|
|
property = "api_bearer_token"
|
|
}
|
|
},
|
|
{
|
|
# Long-lived OAuth token (1-year) from `claude setup-token`.
|
|
# Preferred over the short-lived .credentials.json — CLI picks this up and
|
|
# skips the refresh flow entirely. Rotate yearly; alert 30d before expiry.
|
|
secretKey = "CLAUDE_CODE_OAUTH_TOKEN"
|
|
remoteRef = {
|
|
key = "claude-agent-service"
|
|
property = "claude_oauth_token"
|
|
}
|
|
},
|
|
{
|
|
# Consumed by service-upgrade agent to poll ci.viktorbarzin.me
|
|
# per-workflow status. Pod has no Vault CLI auth, so the old
|
|
# `vault kv get` path is dead — see bd code-3o3.
|
|
secretKey = "WOODPECKER_API_TOKEN"
|
|
remoteRef = {
|
|
key = "ci/global"
|
|
property = "woodpecker_api_token"
|
|
}
|
|
},
|
|
{
|
|
# Consumed by service-upgrade agent for Start/Success/Failure
|
|
# notifications. Same shared webhook as alertmanager.
|
|
secretKey = "SLACK_WEBHOOK_URL"
|
|
remoteRef = {
|
|
key = "viktor"
|
|
property = "alertmanager_slack_api_url"
|
|
}
|
|
},
|
|
]
|
|
}
|
|
}
|
|
depends_on = [kubernetes_namespace.claude_agent]
|
|
}
|
|
|
|
# SOPS age key for terraform state decryption
|
|
resource "kubernetes_secret" "sops_age_key" {
|
|
metadata {
|
|
name = "sops-age-key"
|
|
namespace = kubernetes_namespace.claude_agent.metadata[0].name
|
|
}
|
|
data = {
|
|
"keys.txt" = data.vault_kv_secret_v2.viktor_secrets.data["sops_age_key_devvm"]
|
|
}
|
|
type = "Opaque"
|
|
}
|
|
|
|
# Claude OAuth credentials (for claude -p)
|
|
resource "kubernetes_secret" "claude_credentials" {
|
|
metadata {
|
|
name = "claude-credentials"
|
|
namespace = kubernetes_namespace.claude_agent.metadata[0].name
|
|
}
|
|
data = {
|
|
".credentials.json" = data.vault_kv_secret_v2.secrets.data["claude_credentials_json"]
|
|
}
|
|
type = "Opaque"
|
|
}
|
|
|
|
# git-crypt key for repo decryption
|
|
resource "kubernetes_config_map" "git_crypt_key" {
|
|
metadata {
|
|
name = "git-crypt-key"
|
|
namespace = kubernetes_namespace.claude_agent.metadata[0].name
|
|
}
|
|
binary_data = {
|
|
"key" = filebase64("${path.root}/../../.git/git-crypt/keys/default")
|
|
}
|
|
}
|
|
|
|
# --- RBAC ---
|
|
|
|
resource "kubernetes_service_account" "claude_agent" {
|
|
metadata {
|
|
name = "claude-agent"
|
|
namespace = kubernetes_namespace.claude_agent.metadata[0].name
|
|
}
|
|
}
|
|
|
|
resource "kubernetes_cluster_role" "claude_agent" {
|
|
metadata {
|
|
name = "claude-agent"
|
|
}
|
|
|
|
rule {
|
|
verbs = ["get", "list", "watch"]
|
|
api_groups = ["", "apps", "batch"]
|
|
resources = ["pods", "pods/log", "nodes", "events", "deployments", "services", "namespaces", "jobs", "cronjobs", "configmaps", "replicasets", "statefulsets", "daemonsets"]
|
|
}
|
|
|
|
rule {
|
|
verbs = ["patch", "update"]
|
|
api_groups = ["apps"]
|
|
resources = ["deployments"]
|
|
}
|
|
|
|
rule {
|
|
verbs = ["create"]
|
|
api_groups = [""]
|
|
resources = ["pods/exec"]
|
|
}
|
|
}
|
|
|
|
resource "kubernetes_cluster_role_binding" "claude_agent" {
|
|
metadata {
|
|
name = "claude-agent"
|
|
}
|
|
|
|
subject {
|
|
kind = "ServiceAccount"
|
|
name = kubernetes_service_account.claude_agent.metadata[0].name
|
|
namespace = kubernetes_namespace.claude_agent.metadata[0].name
|
|
}
|
|
|
|
role_ref {
|
|
api_group = "rbac.authorization.k8s.io"
|
|
kind = "ClusterRole"
|
|
name = kubernetes_cluster_role.claude_agent.metadata[0].name
|
|
}
|
|
}
|
|
|
|
# --- Storage ---
|
|
|
|
resource "kubernetes_persistent_volume_claim" "workspace" {
|
|
wait_until_bound = false
|
|
metadata {
|
|
name = "claude-agent-workspace-encrypted"
|
|
namespace = kubernetes_namespace.claude_agent.metadata[0].name
|
|
annotations = {
|
|
"resize.topolvm.io/threshold" = "80%"
|
|
"resize.topolvm.io/increase" = "100%"
|
|
"resize.topolvm.io/storage_limit" = "20Gi"
|
|
}
|
|
}
|
|
spec {
|
|
access_modes = ["ReadWriteOnce"]
|
|
storage_class_name = "proxmox-lvm-encrypted"
|
|
resources {
|
|
requests = {
|
|
storage = "10Gi"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
# --- Deployment ---
|
|
|
|
resource "kubernetes_deployment" "claude_agent" {
|
|
metadata {
|
|
name = "claude-agent-service"
|
|
namespace = kubernetes_namespace.claude_agent.metadata[0].name
|
|
labels = local.labels
|
|
}
|
|
|
|
spec {
|
|
replicas = 1
|
|
strategy {
|
|
type = "Recreate"
|
|
}
|
|
|
|
selector {
|
|
match_labels = local.labels
|
|
}
|
|
|
|
template {
|
|
metadata {
|
|
labels = local.labels
|
|
}
|
|
|
|
spec {
|
|
service_account_name = kubernetes_service_account.claude_agent.metadata[0].name
|
|
|
|
image_pull_secrets {
|
|
name = "registry-credentials"
|
|
}
|
|
|
|
security_context {
|
|
run_as_user = 1000
|
|
run_as_group = 1000
|
|
fs_group = 1000
|
|
}
|
|
|
|
# Fix workspace ownership (PVC may have root-owned files from prior run)
|
|
init_container {
|
|
name = "fix-perms"
|
|
image = "busybox:1.37"
|
|
command = ["sh", "-c", "chown -R 1000:1000 /workspace"]
|
|
security_context {
|
|
run_as_user = 0
|
|
}
|
|
volume_mount {
|
|
name = "workspace"
|
|
mount_path = "/workspace"
|
|
}
|
|
resources {
|
|
requests = {
|
|
memory = "32Mi"
|
|
}
|
|
limits = {
|
|
memory = "64Mi"
|
|
}
|
|
}
|
|
}
|
|
|
|
# Copy Claude credentials to writable volume (CLI needs to refresh OAuth tokens)
|
|
init_container {
|
|
name = "copy-claude-creds"
|
|
image = "busybox:1.37"
|
|
command = ["sh", "-c", "cp /secrets/claude/.credentials.json /home/agent/.claude/.credentials.json && chown 1000:1000 /home/agent/.claude/.credentials.json"]
|
|
security_context {
|
|
run_as_user = 0
|
|
}
|
|
volume_mount {
|
|
name = "claude-credentials-secret"
|
|
mount_path = "/secrets/claude"
|
|
}
|
|
volume_mount {
|
|
name = "claude-home"
|
|
mount_path = "/home/agent/.claude"
|
|
}
|
|
resources {
|
|
requests = {
|
|
memory = "32Mi"
|
|
}
|
|
limits = {
|
|
memory = "64Mi"
|
|
}
|
|
}
|
|
}
|
|
|
|
# Init: clone repo + unlock git-crypt on first run
|
|
init_container {
|
|
name = "git-init"
|
|
image = "${local.image}:${local.image_tag}"
|
|
command = ["sh", "-c", <<-EOF
|
|
set -e
|
|
|
|
# Configure git with HTTPS + PAT
|
|
git config --global user.name "Claude Agent Service"
|
|
git config --global user.email "claude-agent@viktorbarzin.me"
|
|
git config --global --add safe.directory /workspace/infra
|
|
git config --global url."https://$${GITHUB_TOKEN}@github.com/".insteadOf "git@github.com:"
|
|
git config --global url."https://$${GITHUB_TOKEN}@github.com/".insteadOf "https://github.com/"
|
|
|
|
# Clone or update repo
|
|
if [ ! -d /workspace/infra/.git ]; then
|
|
git clone https://$${GITHUB_TOKEN}@github.com/ViktorBarzin/infra.git /workspace/infra
|
|
else
|
|
cd /workspace/infra
|
|
git fetch origin
|
|
git reset --hard origin/master
|
|
fi
|
|
|
|
# Unlock git-crypt
|
|
cd /workspace/infra
|
|
git-crypt unlock /secrets/git-crypt/key || true
|
|
EOF
|
|
]
|
|
|
|
env_from {
|
|
secret_ref {
|
|
name = "claude-agent-secrets"
|
|
}
|
|
}
|
|
|
|
volume_mount {
|
|
name = "workspace"
|
|
mount_path = "/workspace"
|
|
}
|
|
volume_mount {
|
|
name = "git-crypt-key"
|
|
mount_path = "/secrets/git-crypt"
|
|
}
|
|
|
|
resources {
|
|
requests = {
|
|
cpu = "100m"
|
|
memory = "256Mi"
|
|
}
|
|
limits = {
|
|
memory = "512Mi"
|
|
}
|
|
}
|
|
}
|
|
|
|
# Seed beads metadata + beads-task-runner agent into runtime volumes.
|
|
# The Dockerfile stages these files at /usr/share/agent-seed/ (image
|
|
# layer, never mounted). Both /workspace (PVC) and /home/agent/.claude
|
|
# (emptyDir) are volume mounts that hide any image-layer content, so
|
|
# the files have to be copied in at pod start. Also creates the
|
|
# scratch directory the beads-task-runner rails expect.
|
|
init_container {
|
|
name = "seed-beads-agent"
|
|
image = "${local.image}:${local.image_tag}"
|
|
command = ["sh", "-c", <<-EOT
|
|
set -e
|
|
mkdir -p /workspace/.beads /workspace/scratch /home/agent/.claude/agents
|
|
cp /usr/share/agent-seed/beads-metadata.json /workspace/.beads/metadata.json
|
|
cp /usr/share/agent-seed/beads-task-runner.md /home/agent/.claude/agents/beads-task-runner.md
|
|
EOT
|
|
]
|
|
|
|
volume_mount {
|
|
name = "workspace"
|
|
mount_path = "/workspace"
|
|
}
|
|
volume_mount {
|
|
name = "claude-home"
|
|
mount_path = "/home/agent/.claude"
|
|
}
|
|
|
|
resources {
|
|
requests = {
|
|
memory = "32Mi"
|
|
}
|
|
limits = {
|
|
memory = "64Mi"
|
|
}
|
|
}
|
|
}
|
|
|
|
container {
|
|
name = "claude-agent-service"
|
|
image = "${local.image}:${local.image_tag}"
|
|
|
|
port {
|
|
container_port = 8080
|
|
}
|
|
|
|
env_from {
|
|
secret_ref {
|
|
name = "claude-agent-secrets"
|
|
}
|
|
}
|
|
|
|
env {
|
|
name = "WORKSPACE_DIR"
|
|
value = "/workspace/infra"
|
|
}
|
|
|
|
liveness_probe {
|
|
http_get {
|
|
path = "/health"
|
|
port = 8080
|
|
}
|
|
initial_delay_seconds = 10
|
|
period_seconds = 30
|
|
}
|
|
|
|
readiness_probe {
|
|
http_get {
|
|
path = "/health"
|
|
port = 8080
|
|
}
|
|
initial_delay_seconds = 5
|
|
period_seconds = 10
|
|
}
|
|
|
|
volume_mount {
|
|
name = "workspace"
|
|
mount_path = "/workspace"
|
|
}
|
|
volume_mount {
|
|
name = "sops-age-key"
|
|
mount_path = "/home/agent/.config/sops/age"
|
|
}
|
|
volume_mount {
|
|
name = "claude-home"
|
|
mount_path = "/home/agent/.claude"
|
|
}
|
|
|
|
resources {
|
|
requests = {
|
|
cpu = "500m"
|
|
memory = "2Gi"
|
|
}
|
|
limits = {
|
|
memory = "4Gi"
|
|
}
|
|
}
|
|
}
|
|
|
|
volume {
|
|
name = "workspace"
|
|
persistent_volume_claim {
|
|
claim_name = kubernetes_persistent_volume_claim.workspace.metadata[0].name
|
|
}
|
|
}
|
|
|
|
volume {
|
|
name = "sops-age-key"
|
|
secret {
|
|
secret_name = kubernetes_secret.sops_age_key.metadata[0].name
|
|
default_mode = "0600"
|
|
}
|
|
}
|
|
|
|
volume {
|
|
name = "git-crypt-key"
|
|
config_map {
|
|
name = kubernetes_config_map.git_crypt_key.metadata[0].name
|
|
}
|
|
}
|
|
|
|
volume {
|
|
name = "claude-credentials-secret"
|
|
secret {
|
|
secret_name = kubernetes_secret.claude_credentials.metadata[0].name
|
|
default_mode = "0600"
|
|
}
|
|
}
|
|
|
|
volume {
|
|
name = "claude-home"
|
|
empty_dir {}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
lifecycle {
|
|
ignore_changes = [spec[0].template[0].spec[0].dns_config] # KYVERNO_LIFECYCLE_V1
|
|
}
|
|
}
|
|
|
|
# --- Service ---
|
|
|
|
resource "kubernetes_service" "claude_agent" {
|
|
metadata {
|
|
name = "claude-agent-service"
|
|
namespace = kubernetes_namespace.claude_agent.metadata[0].name
|
|
labels = local.labels
|
|
}
|
|
|
|
spec {
|
|
selector = local.labels
|
|
|
|
port {
|
|
port = 8080
|
|
target_port = 8080
|
|
}
|
|
|
|
type = "ClusterIP"
|
|
}
|
|
}
|
|
|
|
# =============================================================================
|
|
# Token expiry monitor
|
|
# Long-lived CLAUDE_CODE_OAUTH_TOKEN values expire 1y after mint. We track
|
|
# mint timestamps here — on rotation, update the map below. A CronJob pushes
|
|
# the computed expiry_timestamp to Pushgateway, Prometheus alerts 30d out.
|
|
# =============================================================================
|
|
locals {
|
|
claude_oauth_token_mint_epochs = {
|
|
# unix seconds (UTC) — when `claude setup-token` finished minting
|
|
"primary" = 1776528429 # 2026-04-18T12:07:09Z (TOKEN2)
|
|
"spare-1" = 1776528280 # 2026-04-18T12:04:40Z (TOKEN1)
|
|
"spare-2" = 1776528429 # 2026-04-18T12:07:09Z (TOKEN2 — redundant w/ primary)
|
|
}
|
|
claude_oauth_token_ttl_seconds = 365 * 24 * 60 * 60
|
|
}
|
|
|
|
resource "kubernetes_config_map" "claude_oauth_expiry" {
|
|
metadata {
|
|
name = "claude-oauth-expiry"
|
|
namespace = kubernetes_namespace.claude_agent.metadata[0].name
|
|
}
|
|
data = {
|
|
for path, mint in local.claude_oauth_token_mint_epochs :
|
|
path => tostring(mint + local.claude_oauth_token_ttl_seconds)
|
|
}
|
|
}
|
|
|
|
resource "kubernetes_cron_job_v1" "claude_oauth_expiry_monitor" {
|
|
metadata {
|
|
name = "claude-oauth-expiry-monitor"
|
|
namespace = kubernetes_namespace.claude_agent.metadata[0].name
|
|
}
|
|
spec {
|
|
concurrency_policy = "Replace"
|
|
failed_jobs_history_limit = 3
|
|
successful_jobs_history_limit = 1
|
|
schedule = "17 */6 * * *" # every 6h at :17 past
|
|
job_template {
|
|
metadata {}
|
|
spec {
|
|
backoff_limit = 1
|
|
ttl_seconds_after_finished = 300
|
|
template {
|
|
metadata {}
|
|
spec {
|
|
restart_policy = "OnFailure"
|
|
container {
|
|
name = "push-expiry"
|
|
image = "docker.io/curlimages/curl:8.11.0"
|
|
command = ["/bin/sh", "-c", <<-EOT
|
|
set -e
|
|
PG='http://prometheus-prometheus-pushgateway.monitoring:9091/metrics/job/claude-oauth-expiry-monitor'
|
|
NOW=$(date +%s)
|
|
PAYLOAD=''
|
|
PAYLOAD="$${PAYLOAD}# HELP claude_oauth_token_expiry_timestamp Unix epoch when the CLAUDE_CODE_OAUTH_TOKEN for this path expires
|
|
"
|
|
PAYLOAD="$${PAYLOAD}# TYPE claude_oauth_token_expiry_timestamp gauge
|
|
"
|
|
for path in /mnt/expiry/*; do
|
|
name=$(basename "$path")
|
|
exp=$(cat "$path")
|
|
PAYLOAD="$${PAYLOAD}claude_oauth_token_expiry_timestamp{path=\"$name\"} $exp
|
|
"
|
|
done
|
|
PAYLOAD="$${PAYLOAD}# HELP claude_oauth_expiry_monitor_last_push_timestamp Last time the expiry monitor pushed metrics
|
|
"
|
|
PAYLOAD="$${PAYLOAD}# TYPE claude_oauth_expiry_monitor_last_push_timestamp gauge
|
|
"
|
|
PAYLOAD="$${PAYLOAD}claude_oauth_expiry_monitor_last_push_timestamp $NOW
|
|
"
|
|
echo "$PAYLOAD"
|
|
echo "$PAYLOAD" | curl -sS --data-binary @- "$PG"
|
|
echo "pushed at $NOW"
|
|
EOT
|
|
]
|
|
volume_mount {
|
|
name = "expiry"
|
|
mount_path = "/mnt/expiry"
|
|
}
|
|
resources {
|
|
requests = { cpu = "10m", memory = "32Mi" }
|
|
limits = { memory = "64Mi" }
|
|
}
|
|
}
|
|
volume {
|
|
name = "expiry"
|
|
config_map {
|
|
name = kubernetes_config_map.claude_oauth_expiry.metadata[0].name
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
lifecycle {
|
|
# KYVERNO_LIFECYCLE_V1: Kyverno admission webhook mutates dns_config with ndots=2
|
|
ignore_changes = [spec[0].job_template[0].spec[0].template[0].spec[0].dns_config]
|
|
}
|
|
}
|