Copy the exact install command from Ankra: it pins the agent version and carries your cluster’s token, and when the cluster has pipeline settings stored, it carries those as further --set flags. Add --set flags for the values below to that command.
A cluster you are connecting:Infrastructure → Clusters → Add a cluster → Connect an existing cluster, tab Install the agent. Name the cluster, select Get the install command, then Show the install command.
A cluster already in Ankra:Infrastructure → Clusters → <your cluster> → Settings → Upgrades and maintenance, section Agent install command, Create install command.
Create install command makes a new agent token and replaces the previous one, so every install command created before it stops working. The command is shown once: leaving the page clears it.
Both need the agents.manage permission, because the command contains the agent’s token. Without it the connect page reads Your role cannot show the install command.
Values across upgrades
When Ankra upgrades the agent, the agent reads the values you set on its release and passes them to the new release, so a value you set with --set survives the upgrade. Five values are Ankra’s and are not carried: config.ankra_url, config.token and the pipeline values ci_worker_count and ci_storage_class come from Ankra, and image.tag is dropped so the image follows the chart version. The CPU and memory values are carried separately, see Set through Ankra.If the release’s values cannot be read, the agent refuses the upgrade rather than reset your values to the chart defaults. The refusal starts Refused the cluster agent upgrade: the current values of the ankra-agent release could not be read, gives the reason, and ends upgrading without them would reset the customer's chart values to the defaults.
Connection
Value
Default
Description
config.ankra_url
https://platform.ankra.app
Platform endpoint the agent connects to
config.token
""
Agent token from the install command (required unless you use an existing Secret)
config.existing_secret_name
""
Read the token from an existing Kubernetes Secret instead
config.secret_key
""
Key within that Secret holding the token
Workers and Performance
Value
Default
Description
read_worker_count
5
Concurrent worker slots for read jobs
write_worker_count
5
Concurrent worker slots for write jobs (create, update, delete)
nats_worker_max_workers
15
Maximum NATS worker threads for processing commands
resources.requests.cpu
200m
CPU request. Set through Ankra (below)
resources.requests.memory
256Mi
Memory request. Set through Ankra (below)
resources.limits.memory
2Gi
Memory limit, sized for the largest pipeline-step pool on a large cluster. An agent first installed under the earlier 1Gi default takes 2Gi at its next upgrade. Set through Ankra (below)
replica_count
1
Agent replicas
terminationGracePeriodSeconds
600
Grace period so in-flight work can finish - don’t set this low
shutdown_drain_seconds
420
How long a stopping agent lets in-flight jobs (Helm applies) finish before cancelling them. Keep it well under terminationGracePeriodSeconds: after the drain the agent still needs about two minutes to unwind and report a cancelled job
strategy
RollingUpdate, maxSurge: 0, maxUnavailable: 1
Rollout strategy of the agent’s Deployment. The old pod releases its resources before its replacement is scheduled, so an upgrade needs no spare room on a full single-node cluster, at the cost of a few seconds without an agent. Override only on clusters with guaranteed headroom
Pipelines
These values shape the Ankra Pipelines steps the agent runs.
Value
Default
Description
ci_worker_count
0
Concurrent worker slots for pipeline steps, separate from the read and write pools. Zero means the agent runs no pipeline-step scheduler and does not advertise the capability, so the platform refuses a pipeline step for this cluster up front. At most 128. Set through Ankra (below)
ci_storage_class
""
StorageClass for pipeline cache volumes and for a workspace claim that names none; empty is the cluster default. Set through Ankra (below)
ci_namespace
ankra-ci
Namespace an ordinary pipeline step (checkout, run, scan, verify) runs in. A step naming any other namespace is refused
ci_build_namespace
ankra-ci-build
Namespace a build step’s rootless BuildKit pod runs in
ci_max_timeout_seconds
21600
Ceiling on a pipeline step’s timeout_seconds, checked by the agent before it runs anything
ci_reservation_image
registry.k8s.io/pause:3.10, pinned by digest
Image of the placeholder pod that holds room for a run’s later steps when run reservation is on for the cluster. Override it on a cluster that cannot pull from registry.k8s.io or admits images only from its own registry
Set through Ankra
ci_worker_count, ci_storage_class and the agent’s CPU and memory requests and limits are values Ankra holds per cluster. Every install or upgrade command Ankra generates for the cluster carries them, and a value Ankra holds wins over the one the running Deployment carries. Set them with the CLI:
ankra cluster agent resources set --memory-limit 2Gi --cluster my-clusterankra cluster agent ci set --workers 50 --cluster my-cluster
Read them back with ankra cluster agent resources get and ankra cluster agent ci get. Both set commands say whether the agent took the values right away or takes them at its next upgrade. See ankra cluster agent resources and ankra cluster agent ci.
Kubernetes Watch
Streaming of live resource state to the platform. Only override when you need to tune event volume.
Value
Default
Description
k8s_watch.enabled
true
Enable the resource watch stream
k8s_watch.batch_size
20
Events per batch
k8s_watch.batch_timeout_ms
500
Max wait before flushing a partial batch
k8s_watch.reconnect_delay_ms
1000
Initial reconnect delay
k8s_watch.max_reconnect_delay_ms
30000
Reconnect backoff ceiling
k8s_watch.max_events_per_sec
500
Event rate limit
k8s_watch.strip_fields
true
Remove metadata.managedFields and the kubectl last-applied annotation from each watched object before it is sent, to keep payloads small. false takes effect on agent 2.1.1336 or later; older agents ignore it and keep removing them
k8s_watch.timeout_seconds
300
Watch connection timeout
k8s_watch.buffer_replay_interval_sec
5
How often watch batches buffered on disk after a failed publish are retried
k8s_watch.buffer_replay_backoff_max_sec
60
Ceiling of the retry backoff
k8s_watch.redact_secrets
true
Replace the values of Secret data and stringData with SHA-256 digests in the watch stream and in full-sync listings, before they leave the cluster. A read of one named Secret and a single-page list read keep the values. Set false only for debugging
k8s_watch.dynamic_discovery
true
Watch every served resource type (CRDs, operator resources) in addition to the built-in list, up to dynamic_discovery_max_watches. false keeps the cluster on the built-in list
k8s_watch.dynamic_discovery_max_watches
200
Most resource types discovery watches
Hosted Logs
The agent can follow the logs of the cluster’s running containers through the API server, up to logs_ship.max_containers at once, and send the lines to Ankra’s hosted log store. Whether it does is decided per cluster in Ankra, and the switch is off until someone turns it on; see Hosted Logs. These values are the local limits.
Value
Default
Description
logs_ship.enabled
true
Local permission for hosted log shipping. true lets the agent obey the cluster’s switch in Ankra. false is a local opt-out that wins over the platform: the log shipper never runs, and the agent tells the platform it will not obey the switch
logs_ship.max_containers
100
Most containers followed at once, one API server log stream each
logs_ship.exclude_namespaces
""
Comma-separated namespaces whose logs are never shipped, such as kube-system,monitoring
logs_ship.max_bytes_per_second
262144 (256 KiB/s)
Send rate limit in raw log-line bytes per second, which is the platform’s per-cluster ingest allowance: the platform discards anything past it. Lines held back wait in the kubelet’s log files rather than being dropped. A value that is not positive falls back to the default
logs_ship.burst_bytes
8388608 (8 MiB)
Bytes the shipper may send ahead of the rate limit after a quiet spell or at start
Image
Value
Default
Description
image.repository
registry.ankra.cloud/ankra/agent
Agent image
image.tag
"" (follows chart version)
Explicit tag override - empty is what Ankra’s automatic upgrades rely on; set only to pin a specific build. Ankra replaces it on upgrade (see Values across upgrades)
image.pull_policy
Always
Image pull policy
image.pull_secrets
[]
Pull secrets
Security
The chart enforces non-root defaults matching the image’s ankra user (UID/GID 1000) with a read-only root filesystem. Don’t lower these without a rebuilt image.
Value
Default
Description
pod_security_context
non-root, UID/GID 1000, RuntimeDefault seccomp
Pod-level security context
security_context
non-root, no privilege escalation, read-only rootfs, all capabilities dropped
Container-level security context
writable_volumes.enabled
true
Mount emptyDir volumes for runtime-writable paths (required with read-only rootfs)
writable_volumes.tmp_size_limit
1Gi
/tmp size cap
writable_volumes.cache_size_limit
4Gi
Cache size cap
writable_volumes.config_size_limit
16Mi
Config size cap
pod_security_labels_enabled
true
Keeps every namespace’s Pod Security Admission labels in line with the ankra-pod-security ConfigMap the security baseline ships. Turn it off only while diagnosing: with it off, a cluster’s Enforce mode is declared and never applied
Fixed node port, used only when service.type is NodePort
service.annotations
{}
Annotations on the agent’s Service
pod_annotations
{}
Extra pod annotations
log_level
INFO
DEBUG, INFO, WARNING or ERROR, in any case. WARN is read as WARNING, CRITICAL and FATAL as ERROR; anything else falls back to INFO
Metrics
Value
Default
Description
metrics.serviceMonitor.enabled
false
Install a Prometheus Operator ServiceMonitor scraping /metrics
metrics.serviceMonitor.interval
30s
Scrape interval
metrics.serviceMonitor.scrapeTimeout
10s
Scrape timeout
metrics.serviceMonitor.labels
{}
Extra ServiceMonitor labels
metrics.prometheusRule.enabled
false
Install a Prometheus Operator PrometheusRule that alerts when the agent is OOM-killed or restarts in a loop (AnkraAgentOOMKilled, AnkraAgentRestartLoop). Needs kube-state-metrics in the cluster
metrics.prometheusRule.labels
{}
Extra PrometheusRule labels
metrics_collect.enabled
true
Ship built-in cluster metrics (nodes, namespaces, workloads) to the Ankra platform. false turns collection off on agent 2.1.1336 or later; older agents ignore it and keep sending metrics
metrics_collect.interval_seconds
30
Collection interval
metrics_collect.max_workloads
200
Cap on per-workload series (top by CPU; restarting workloads are always kept)
Public IP Reporting
Makes the agent report its public egress IP to Ankra on check-in. Disabled by default; enabling it makes the agent perform an outbound HTTP lookup to public_ip.lookup_url. Leave it disabled for air-gapped clusters.
Value
Default
Description
public_ip.reporting_enabled
false
Report the agent’s public egress IP on check-in
public_ip.lookup_url
https://api.ipify.org?format=json
Endpoint returning the caller’s public IP, as JSON {"ip": "..."} or plain text
public_ip.refresh_seconds
3600
How often the cached IP is refreshed
public_ip.lookup_timeout_seconds
5
Per-lookup HTTP timeout
Diagnostics
Value
Default
Description
pprof.enabled
false
Serve Go’s /debug/pprof/ profiling handlers on the health port, 8080. Turn it on only while taking a heap profile or goroutine dump from the agent
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Ankra","colors":{"primary":"#5d64ff","light":"#5d64ff","dark":"#3f48b2"},"logo":{"light":"https://mintcdn.com/ankra/uW749bPYey14eJsU/logo/light.svg?fit=max\u0026auto=format\u0026n=uW749bPYey14eJsU\u0026q=85\u0026s=7f48236f76559638a5a154da424c91d6","dark":"https://mintcdn.com/ankra/uW749bPYey14eJsU/logo/dark.svg?fit=max\u0026auto=format\u0026n=uW749bPYey14eJsU\u0026q=85\u0026s=4e4b278d2d7c90f2c8ff4ac9cc95c78a","href":"https://ankra.ai"},"favicon":"https://mintcdn.com/ankra/uW749bPYey14eJsU/favicon.ico?fit=max\u0026auto=format\u0026n=uW749bPYey14eJsU\u0026q=85\u0026s=68fd8c280641a74d9a2171dfa7b39219","api":{"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["python","javascript","curl"]},"mdx":{"auth":{"method":"bearer"}}},"navbar":{"links":[{"href":"mailto:[email protected]","label":"Support"}],"primary":{"type":"button","label":"Platform","href":"https://platform.ankra.app/next"}},"footer":{"socials":{"linkedin":"https://linkedin.com/company/ankra","github":"https://github.com/ankraio","slack":"https://join.slack.com/t/ankra-community/shared_invite/zt-3a5rem8f8-cUho4epX2MoLT83bFf~VSA"}},"seo":{"metatags":{"og:site_name":"Ankra"}},"integrations":{"posthog":{"apiKey":"phc_c1cRSlsPgqJH5IGiQYzk40R91jQxf2e3ZaZVwO5e6OM","apiHost":"https://eu.i.posthog.com"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Community","icon":"slack","href":"https://join.slack.com/t/ankra-community/shared_invite/zt-3a5rem8f8-cUho4epX2MoLT83bFf~VSA"},{"anchor":"Youtube","icon":"youtube","href":"https://www.youtube.com/@ankraio"},{"anchor":"Blog","icon":"newspaper","href":"https://www.ankra.ai/blog"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ankra","hasAudioNarration":false,"actualSubdomain":"ankra","customDomains":["docs.ankra.ai"],"gitSource":{"type":"github","owner":"ankraio","repo":"ankra-docs","deployBranch":"master","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6afb3e953b86427e404ec10c","clientVersion":"0.0.4149","searchFilterCounts":[{"language":"default","tag":"API Reference","count":2231},{"language":"default","tag":"Endpoints","count":2229},{"language":"default","tag":"Documentation","count":316},{"language":"default","tag":"Applications","count":186},{"language":"default","tag":"Security","count":125},{"language":"default","tag":"Ankra Cloud Clusters","count":109},{"language":"default","tag":"AWS Clusters","count":107},{"language":"default","tag":"Pipelines","count":107},{"language":"default","tag":"Scaleway Clusters","count":107},{"language":"default","tag":"Stack Profiles","count":104}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"reference/agent-helm-values","slug":"/reference/agent-helm-values","pageMetadata":{"title":"Agent Helm Values","description":"Every configurable value of the ankra-agent Helm chart - workers, pipelines, watch tuning, logs, metrics, security contexts and rollout.","href":"/reference/agent-helm-values"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Every configurable value of the ankra-agent Helm chart - workers, pipelines, watch tuning, logs, metrics, security contexts and rollout.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];const CliVersion=({since,command,note})=>{const _components={a:`a`,..._provideComponents()};const latestStableCli=`0.78.0`;const parse=version=>String(version).split(`.`).map(part=>parseInt(part,10)||0);const requested=parse(since);const stable=parse(latestStableCli);let isPrerelease=false;for(let index=0;index\u003c3;index+=1){if(requested[index]>stable[index]){isPrerelease=true;break}if(requested[index]\u003cstable[index]){break}}const containerStyle={display:`flex`,alignItems:`baseline`,gap:`0.6rem`,margin:`1rem 0`,padding:`0.6rem 0.9rem`,border:`1px solid rgba(128, 128, 128, 0.35)`,borderRadius:`0.5rem`,fontSize:`0.9em`,lineHeight:1.5};const pillStyle={flex:`none`,padding:`0.1rem 0.5rem`,borderRadius:`999px`,background:`rgba(128, 128, 128, 0.18)`,fontFamily:`ui-monospace, SFMono-Regular, Menlo, monospace`,fontSize:`0.85em`,fontWeight:600,whiteSpace:`nowrap`};const keepTogether={whiteSpace:`nowrap`};return _jsxs(`div`,{style:containerStyle,\"data-cli-version\":since,children:[_jsxs(`span`,{style:pillStyle,children:[`CLI v`,since,`+`]}),_jsxs(`span`,{children:[command?_jsxs(`span`,{children:[_jsx(`span`,{style:keepTogether,children:_jsxs(`code`,{children:[`ankra `,command]})}),` `,`needs`]}):_jsx(`span`,{children:`The commands on this page need`}),` `,`the ankra CLI `,_jsxs(`strong`,{style:keepTogether,children:[`v`,since,` or later`]}),isPrerelease?_jsxs(`span`,{children:[` `,`- a pre-release today, so enable the`,` `,_jsx(_components.a,{href:`/integrations/ankra-cli#beta-pre-release-channel`,children:`beta channel`}),` before upgrading`]}):null,`. Check yours with`,` `,_jsx(`span`,{style:keepTogether,children:_jsx(`code`,{children:`ankra --version`})}),`; `,_jsx(_components.a,{href:`/integrations/ankra-cli#upgrading-the-cli`,children:`upgrade`}),` with`,` `,_jsx(`span`,{style:keepTogether,children:_jsx(`code`,{children:`ankra upgrade`})}),`.`,note?_jsxs(`span`,{children:[` `,note]}):null]})]})};function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Warning,_MdxComponentBoundary}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);if(!_MdxComponentBoundary)_missingMdxReference(`_MdxComponentBoundary`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Reference for the `,_jsx(_components.code,{children:`ankra-agent`}),` chart installed from `,_jsx(_components.code,{children:`oci://registry.ankra.cloud/ankra/ankra-agent`}),`. For installation and architecture, see `,_jsx(_components.a,{href:`/concepts/cluster-agent`,children:`Cluster Agent`}),`.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`5`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`helm`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` upgrade`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --install`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` ankra-agent`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` oci://registry.ankra.cloud/ankra/ankra-agent`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --version`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`agent-versio`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`n`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --set`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` config.ankra_url=https://platform.ankra.app`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --set`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` config.token=`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`\u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`your-toke`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`n`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --namespace=ankra`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --create-namespace`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Copy the exact install command from Ankra: it pins the agent version and carries your cluster’s token, and when the cluster has pipeline settings stored, it carries those as further `,_jsx(_components.code,{children:`--set`}),` flags. Add `,_jsx(_components.code,{children:`--set`}),` flags for the values below to that command.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`A cluster you are connecting:`}),` `,_jsx(_components.strong,{children:`Infrastructure → Clusters → Add a cluster → Connect an existing cluster`}),`, tab `,_jsx(_components.strong,{children:`Install the agent`}),`. Name the cluster, select `,_jsx(_components.strong,{children:`Get the install command`}),`, then `,_jsx(_components.strong,{children:`Show the install command`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`A cluster already in Ankra:`}),` `,_jsx(_components.strong,{children:`Infrastructure → Clusters → \u003cyour cluster> → Settings → Upgrades and maintenance`}),`, section `,_jsx(_components.strong,{children:`Agent install command`}),`, `,_jsx(_components.strong,{children:`Create install command`}),`.`]}),`\n`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Create install command`}),` makes a new agent token and replaces the previous one, so every install command created before it stops working. The command is shown once: leaving the page clears it.`]})}),`\n`,_jsxs(_components.p,{children:[`Both need the `,_jsx(_components.code,{children:`agents.manage`}),` permission, because the command contains the agent’s token. Without it the connect page reads `,_jsx(_components.strong,{children:`Your role cannot show the install command`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`values-across-upgrades`,children:`Values across upgrades`}),`\n`,_jsxs(_components.p,{children:[`When Ankra upgrades the agent, the agent reads the values you set on its release and passes them to the new release, so a value you set with `,_jsx(_components.code,{children:`--set`}),` survives the upgrade. Five values are Ankra’s and are not carried: `,_jsx(_components.code,{children:`config.ankra_url`}),`, `,_jsx(_components.code,{children:`config.token`}),` and the pipeline values `,_jsx(_components.code,{children:`ci_worker_count`}),` and `,_jsx(_components.code,{children:`ci_storage_class`}),` come from Ankra, and `,_jsx(_components.code,{children:`image.tag`}),` is dropped so the image follows the chart version. The CPU and memory values are carried separately, see `,_jsx(_components.a,{href:`#set-through-ankra`,children:`Set through Ankra`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`If the release’s values cannot be read, the agent refuses the upgrade rather than reset your values to the chart defaults. The refusal starts `,_jsx(_components.code,{children:`Refused the cluster agent upgrade: the current values of the ankra-agent release could not be read`}),`, gives the reason, and ends `,_jsx(_components.code,{children:`upgrading without them would reset the customer's chart values to the defaults.`})]}),`\n`,_jsx(Heading,{level:`2`,id:`connection`,children:`Connection`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Value`}),_jsx(_components.th,{children:`Default`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`config.ankra_url`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`https://platform.ankra.app`})}),_jsx(_components.td,{children:`Platform endpoint the agent connects to`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`config.token`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\"\"`})}),_jsx(_components.td,{children:`Agent token from the install command (required unless you use an existing Secret)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`config.existing_secret_name`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\"\"`})}),_jsx(_components.td,{children:`Read the token from an existing Kubernetes Secret instead`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`config.secret_key`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\"\"`})}),_jsx(_components.td,{children:`Key within that Secret holding the token`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`workers-and-performance`,children:`Workers and Performance`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Value`}),_jsx(_components.th,{children:`Default`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`read_worker_count`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`5`})}),_jsx(_components.td,{children:`Concurrent worker slots for read jobs`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`write_worker_count`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`5`})}),_jsx(_components.td,{children:`Concurrent worker slots for write jobs (create, update, delete)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`nats_worker_max_workers`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`15`})}),_jsx(_components.td,{children:`Maximum NATS worker threads for processing commands`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`resources.requests.cpu`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`200m`})}),_jsxs(_components.td,{children:[`CPU request. `,_jsx(_components.strong,{children:`Set through Ankra`}),` (below)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`resources.requests.memory`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`256Mi`})}),_jsxs(_components.td,{children:[`Memory request. `,_jsx(_components.strong,{children:`Set through Ankra`}),` (below)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`resources.limits.memory`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`2Gi`})}),_jsxs(_components.td,{children:[`Memory limit, sized for the largest pipeline-step pool on a large cluster. An agent first installed under the earlier `,_jsx(_components.code,{children:`1Gi`}),` default takes `,_jsx(_components.code,{children:`2Gi`}),` at its next upgrade. `,_jsx(_components.strong,{children:`Set through Ankra`}),` (below)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`replica_count`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`1`})}),_jsx(_components.td,{children:`Agent replicas`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`terminationGracePeriodSeconds`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`600`})}),_jsx(_components.td,{children:`Grace period so in-flight work can finish - don’t set this low`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`shutdown_drain_seconds`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`420`})}),_jsxs(_components.td,{children:[`How long a stopping agent lets in-flight jobs (Helm applies) finish before cancelling them. Keep it well under `,_jsx(_components.code,{children:`terminationGracePeriodSeconds`}),`: after the drain the agent still needs about two minutes to unwind and report a cancelled job`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`strategy`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`RollingUpdate`}),`, `,_jsx(_components.code,{children:`maxSurge: 0`}),`, `,_jsx(_components.code,{children:`maxUnavailable: 1`})]}),_jsx(_components.td,{children:`Rollout strategy of the agent’s Deployment. The old pod releases its resources before its replacement is scheduled, so an upgrade needs no spare room on a full single-node cluster, at the cost of a few seconds without an agent. Override only on clusters with guaranteed headroom`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`pipelines`,children:`Pipelines`}),`\n`,_jsxs(_components.p,{children:[`These values shape the `,_jsx(_components.a,{href:`/guides/ankra-pipelines`,children:`Ankra Pipelines`}),` steps the agent runs.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Value`}),_jsx(_components.th,{children:`Default`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ci_worker_count`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`0`})}),_jsxs(_components.td,{children:[`Concurrent worker slots for pipeline steps, separate from the read and write pools. Zero means the agent runs no pipeline-step scheduler and does not advertise the capability, so the platform refuses a pipeline step for this cluster up front. At most 128. `,_jsx(_components.strong,{children:`Set through Ankra`}),` (below)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ci_storage_class`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\"\"`})}),_jsxs(_components.td,{children:[`StorageClass for pipeline cache volumes and for a workspace claim that names none; empty is the cluster default. `,_jsx(_components.strong,{children:`Set through Ankra`}),` (below)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ci_namespace`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`ankra-ci`})}),_jsx(_components.td,{children:`Namespace an ordinary pipeline step (checkout, run, scan, verify) runs in. A step naming any other namespace is refused`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ci_build_namespace`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`ankra-ci-build`})}),_jsx(_components.td,{children:`Namespace a build step’s rootless BuildKit pod runs in`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ci_max_timeout_seconds`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`21600`})}),_jsxs(_components.td,{children:[`Ceiling on a pipeline step’s `,_jsx(_components.code,{children:`timeout_seconds`}),`, checked by the agent before it runs anything`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ci_reservation_image`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`registry.k8s.io/pause:3.10`}),`, pinned by digest`]}),_jsxs(_components.td,{children:[`Image of the placeholder pod that holds room for a run’s later steps when run reservation is on for the cluster. Override it on a cluster that cannot pull from `,_jsx(_components.code,{children:`registry.k8s.io`}),` or admits images only from its own registry`]})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`set-through-ankra`,children:`Set through Ankra`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`ci_worker_count`}),`, `,_jsx(_components.code,{children:`ci_storage_class`}),` and the agent’s CPU and memory requests and limits are values Ankra holds per cluster. Every install or upgrade command Ankra generates for the cluster carries them, and a value Ankra holds wins over the one the running Deployment carries. Set them with the CLI:`]}),`\n`,_jsx(_MdxComponentBoundary,{name:`CliVersion`,children:_jsx(CliVersion,{since:`0.34.0`})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`ankra`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` cluster`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` agent`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` resources`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` set`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --memory-limit`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 2Gi`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --cluster`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` my-cluster`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`ankra`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` cluster`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` agent`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` ci`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` set`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --workers`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 50`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --cluster`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` my-cluster`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Read them back with `,_jsx(_components.code,{children:`ankra cluster agent resources get`}),` and `,_jsx(_components.code,{children:`ankra cluster agent ci get`}),`. Both `,_jsx(_components.code,{children:`set`}),` commands say whether the agent took the values right away or takes them at its next upgrade. See `,_jsx(_components.a,{href:`/reference/cli/cluster#ankra-cluster-agent-resources`,children:_jsx(_components.code,{children:`ankra cluster agent resources`})}),` and `,_jsx(_components.a,{href:`/reference/cli/cluster#ankra-cluster-agent-ci`,children:_jsx(_components.code,{children:`ankra cluster agent ci`})}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`kubernetes-watch`,children:`Kubernetes Watch`}),`\n`,_jsx(_components.p,{children:`Streaming of live resource state to the platform. Only override when you need to tune event volume.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Value`}),_jsx(_components.th,{children:`Default`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`k8s_watch.enabled`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`true`})}),_jsx(_components.td,{children:`Enable the resource watch stream`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`k8s_watch.batch_size`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`20`})}),_jsx(_components.td,{children:`Events per batch`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`k8s_watch.batch_timeout_ms`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`500`})}),_jsx(_components.td,{children:`Max wait before flushing a partial batch`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`k8s_watch.reconnect_delay_ms`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`1000`})}),_jsx(_components.td,{children:`Initial reconnect delay`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`k8s_watch.max_reconnect_delay_ms`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`30000`})}),_jsx(_components.td,{children:`Reconnect backoff ceiling`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`k8s_watch.max_events_per_sec`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`500`})}),_jsx(_components.td,{children:`Event rate limit`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`k8s_watch.strip_fields`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`true`})}),_jsxs(_components.td,{children:[`Remove `,_jsx(_components.code,{children:`metadata.managedFields`}),` and the `,_jsx(_components.code,{children:`kubectl`}),` last-applied annotation from each watched object before it is sent, to keep payloads small. `,_jsx(_components.code,{children:`false`}),` takes effect on agent 2.1.1336 or later; older agents ignore it and keep removing them`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`k8s_watch.timeout_seconds`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`300`})}),_jsx(_components.td,{children:`Watch connection timeout`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`k8s_watch.buffer_replay_interval_sec`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`5`})}),_jsx(_components.td,{children:`How often watch batches buffered on disk after a failed publish are retried`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`k8s_watch.buffer_replay_backoff_max_sec`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`60`})}),_jsx(_components.td,{children:`Ceiling of the retry backoff`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`k8s_watch.redact_secrets`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`true`})}),_jsxs(_components.td,{children:[`Replace the values of Secret `,_jsx(_components.code,{children:`data`}),` and `,_jsx(_components.code,{children:`stringData`}),` with SHA-256 digests in the watch stream and in full-sync listings, before they leave the cluster. A read of one named Secret and a single-page list read keep the values. Set `,_jsx(_components.code,{children:`false`}),` only for debugging`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`k8s_watch.dynamic_discovery`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`true`})}),_jsxs(_components.td,{children:[`Watch every served resource type (CRDs, operator resources) in addition to the built-in list, up to `,_jsx(_components.code,{children:`dynamic_discovery_max_watches`}),`. `,_jsx(_components.code,{children:`false`}),` keeps the cluster on the built-in list`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`k8s_watch.dynamic_discovery_max_watches`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`200`})}),_jsx(_components.td,{children:`Most resource types discovery watches`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`hosted-logs`,children:`Hosted Logs`}),`\n`,_jsxs(_components.p,{children:[`The agent can follow the logs of the cluster’s running containers through the API server, up to `,_jsx(_components.code,{children:`logs_ship.max_containers`}),` at once, and send the lines to Ankra’s hosted log store. Whether it does is decided per cluster in Ankra, and the switch is off until someone turns it on; see `,_jsx(_components.a,{href:`/guides/hosted-logs`,children:`Hosted Logs`}),`. These values are the local limits.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Value`}),_jsx(_components.th,{children:`Default`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`logs_ship.enabled`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`true`})}),_jsxs(_components.td,{children:[`Local permission for hosted log shipping. `,_jsx(_components.code,{children:`true`}),` lets the agent obey the cluster’s switch in Ankra. `,_jsx(_components.code,{children:`false`}),` is a local opt-out that wins over the platform: the log shipper never runs, and the agent tells the platform it will not obey the switch`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`logs_ship.max_containers`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`100`})}),_jsx(_components.td,{children:`Most containers followed at once, one API server log stream each`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`logs_ship.exclude_namespaces`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\"\"`})}),_jsxs(_components.td,{children:[`Comma-separated namespaces whose logs are never shipped, such as `,_jsx(_components.code,{children:`kube-system,monitoring`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`logs_ship.max_bytes_per_second`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`262144`}),` (256 KiB/s)`]}),_jsx(_components.td,{children:`Send rate limit in raw log-line bytes per second, which is the platform’s per-cluster ingest allowance: the platform discards anything past it. Lines held back wait in the kubelet’s log files rather than being dropped. A value that is not positive falls back to the default`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`logs_ship.burst_bytes`})}),_jsxs(_components.td,{\"data-numeric\":`true`,children:[_jsx(_components.code,{children:`8388608`}),` (8 MiB)`]}),_jsx(_components.td,{children:`Bytes the shipper may send ahead of the rate limit after a quiet spell or at start`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`image`,children:`Image`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Value`}),_jsx(_components.th,{children:`Default`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`image.repository`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`registry.ankra.cloud/ankra/agent`})}),_jsx(_components.td,{children:`Agent image`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`image.tag`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`\"\"`}),` (follows chart version)`]}),_jsxs(_components.td,{children:[`Explicit tag override - empty is what Ankra’s automatic upgrades rely on; set only to pin a specific build. Ankra replaces it on upgrade (see `,_jsx(_components.a,{href:`#values-across-upgrades`,children:`Values across upgrades`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`image.pull_policy`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Always`})}),_jsx(_components.td,{children:`Image pull policy`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`image.pull_secrets`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`[]`})}),_jsx(_components.td,{children:`Pull secrets`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`security`,children:`Security`}),`\n`,_jsxs(_components.p,{children:[`The chart enforces non-root defaults matching the image’s `,_jsx(_components.code,{children:`ankra`}),` user (UID/GID 1000) with a read-only root filesystem. Don’t lower these without a rebuilt image.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Value`}),_jsx(_components.th,{children:`Default`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`pod_security_context`})}),_jsxs(_components.td,{children:[`non-root, UID/GID 1000, `,_jsx(_components.code,{children:`RuntimeDefault`}),` seccomp`]}),_jsx(_components.td,{children:`Pod-level security context`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`security_context`})}),_jsx(_components.td,{children:`non-root, no privilege escalation, read-only rootfs, all capabilities dropped`}),_jsx(_components.td,{children:`Container-level security context`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`writable_volumes.enabled`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`true`})}),_jsx(_components.td,{children:`Mount emptyDir volumes for runtime-writable paths (required with read-only rootfs)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`writable_volumes.tmp_size_limit`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`1Gi`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`/tmp`}),` size cap`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`writable_volumes.cache_size_limit`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`4Gi`})}),_jsx(_components.td,{children:`Cache size cap`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`writable_volumes.config_size_limit`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`16Mi`})}),_jsx(_components.td,{children:`Config size cap`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`pod_security_labels_enabled`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`true`})}),_jsxs(_components.td,{children:[`Keeps every namespace’s Pod Security Admission labels in line with the `,_jsx(_components.code,{children:`ankra-pod-security`}),` ConfigMap the security baseline ships. Turn it off only while diagnosing: with it off, a cluster’s Enforce mode is declared and never applied`]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`scheduling-and-service`,children:`Scheduling and Service`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Value`}),_jsx(_components.th,{children:`Default`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`node_selector`}),` / `,_jsx(_components.code,{children:`tolerations`}),` / `,_jsx(_components.code,{children:`affinity`}),` / `,_jsx(_components.code,{children:`topologySpreadConstraints`})]}),_jsx(_components.td,{children:`empty`}),_jsx(_components.td,{children:`Standard scheduling controls`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`service_account.name`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`ankra-agent-sa`})}),_jsx(_components.td,{children:`Service account name`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`service_account.annotations`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`{}`})}),_jsx(_components.td,{children:`Service account annotations (e.g. IRSA)`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`service.type`}),` / `,_jsx(_components.code,{children:`service.port`})]}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`ClusterIP`}),` / `,_jsx(_components.code,{children:`8080`})]}),_jsx(_components.td,{children:`Agent HTTP service`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`service.node_port`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\"\"`})}),_jsxs(_components.td,{children:[`Fixed node port, used only when `,_jsx(_components.code,{children:`service.type`}),` is `,_jsx(_components.code,{children:`NodePort`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`service.annotations`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`{}`})}),_jsx(_components.td,{children:`Annotations on the agent’s Service`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`pod_annotations`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`{}`})}),_jsx(_components.td,{children:`Extra pod annotations`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`log_level`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`INFO`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`DEBUG`}),`, `,_jsx(_components.code,{children:`INFO`}),`, `,_jsx(_components.code,{children:`WARNING`}),` or `,_jsx(_components.code,{children:`ERROR`}),`, in any case. `,_jsx(_components.code,{children:`WARN`}),` is read as `,_jsx(_components.code,{children:`WARNING`}),`, `,_jsx(_components.code,{children:`CRITICAL`}),` and `,_jsx(_components.code,{children:`FATAL`}),` as `,_jsx(_components.code,{children:`ERROR`}),`; anything else falls back to `,_jsx(_components.code,{children:`INFO`})]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`metrics`,children:`Metrics`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Value`}),_jsx(_components.th,{children:`Default`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`metrics.serviceMonitor.enabled`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`false`})}),_jsxs(_components.td,{children:[`Install a Prometheus Operator ServiceMonitor scraping `,_jsx(_components.code,{children:`/metrics`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`metrics.serviceMonitor.interval`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`30s`})}),_jsx(_components.td,{children:`Scrape interval`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`metrics.serviceMonitor.scrapeTimeout`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`10s`})}),_jsx(_components.td,{children:`Scrape timeout`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`metrics.serviceMonitor.labels`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`{}`})}),_jsx(_components.td,{children:`Extra ServiceMonitor labels`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`metrics.prometheusRule.enabled`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`false`})}),_jsxs(_components.td,{children:[`Install a Prometheus Operator PrometheusRule that alerts when the agent is OOM-killed or restarts in a loop (`,_jsx(_components.code,{children:`AnkraAgentOOMKilled`}),`, `,_jsx(_components.code,{children:`AnkraAgentRestartLoop`}),`). Needs kube-state-metrics in the cluster`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`metrics.prometheusRule.labels`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`{}`})}),_jsx(_components.td,{children:`Extra PrometheusRule labels`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`metrics_collect.enabled`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`true`})}),_jsxs(_components.td,{children:[`Ship built-in cluster metrics (nodes, namespaces, workloads) to the Ankra platform. `,_jsx(_components.code,{children:`false`}),` turns collection off on agent 2.1.1336 or later; older agents ignore it and keep sending metrics`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`metrics_collect.interval_seconds`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`30`})}),_jsx(_components.td,{children:`Collection interval`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`metrics_collect.max_workloads`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`200`})}),_jsx(_components.td,{children:`Cap on per-workload series (top by CPU; restarting workloads are always kept)`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`public-ip-reporting`,children:`Public IP Reporting`}),`\n`,_jsxs(_components.p,{children:[`Makes the agent report its public egress IP to Ankra on check-in. Disabled by default; enabling it makes the agent perform an outbound HTTP lookup to `,_jsx(_components.code,{children:`public_ip.lookup_url`}),`. Leave it disabled for air-gapped clusters.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Value`}),_jsx(_components.th,{children:`Default`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`public_ip.reporting_enabled`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`false`})}),_jsx(_components.td,{children:`Report the agent’s public egress IP on check-in`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`public_ip.lookup_url`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`https://api.ipify.org?format=json`})}),_jsxs(_components.td,{children:[`Endpoint returning the caller’s public IP, as JSON `,_jsx(_components.code,{children:`{\"ip\": \"...\"}`}),` or plain text`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`public_ip.refresh_seconds`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`3600`})}),_jsx(_components.td,{children:`How often the cached IP is refreshed`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`public_ip.lookup_timeout_seconds`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`5`})}),_jsx(_components.td,{children:`Per-lookup HTTP timeout`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`diagnostics`,children:`Diagnostics`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Value`}),_jsx(_components.th,{children:`Default`}),_jsx(_components.th,{children:`Description`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`pprof.enabled`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`false`})}),_jsxs(_components.td,{children:[`Serve Go’s `,_jsx(_components.code,{children:`/debug/pprof/`}),` profiling handlers on the health port, 8080. Turn it on only while taking a heap profile or goroutine dump from the agent`]})]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`advanced-environment-tuning`,children:`Advanced Environment Tuning`}),`\n`,_jsxs(_components.p,{children:[`Operator-tunable knobs go in `,_jsx(_components.code,{children:`extra_env`}),`:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`7`,language:`yaml`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`yaml`,children:_jsxs(_components.code,{language:`yaml`,numberOfLines:`7`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`extra_env`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` - `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`name`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`KUBERNETES_HTTP2_ENABLED`}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` # default \"false\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:` value`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"false\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` - `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`name`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`KUBERNETES_REQUEST_MAX_ATTEMPTS`}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` # default \"3\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:` value`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"3\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` - `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`name`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`FORWARD_SERVICE_REQUEST_MAX_TIMEOUT_SECONDS`}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` # default \"120\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:` value`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"120\"`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`/concepts/cluster-agent#advanced-tuning-via-extra_env`,children:`Cluster Agent - Advanced tuning`}),` for when to change these.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{CliVersion,default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Agent Helm Values","description":"Every configurable value of the ankra-agent Helm chart - workers, pipelines, watch tuning, logs, metrics, security contexts and rollout.","href":"/reference/agent-helm-values"}}},"mdxSourceWithNoJs":null,"noJsSplices":[[146,2060,")=>null;function _cr"]]},"mdxExtracts":{"tableOfContents":[{"title":"Values across upgrades","slug":"values-across-upgrades","depth":2,"children":[]},{"title":"Connection","slug":"connection","depth":2,"children":[]},{"title":"Workers and Performance","slug":"workers-and-performance","depth":2,"children":[]},{"title":"Pipelines","slug":"pipelines","depth":2,"children":[{"title":"Set through Ankra","slug":"set-through-ankra","depth":3,"children":[]}]},{"title":"Kubernetes Watch","slug":"kubernetes-watch","depth":2,"children":[]},{"title":"Hosted Logs","slug":"hosted-logs","depth":2,"children":[]},{"title":"Image","slug":"image","depth":2,"children":[]},{"title":"Security","slug":"security","depth":2,"children":[]},{"title":"Scheduling and Service","slug":"scheduling-and-service","depth":2,"children":[]},{"title":"Metrics","slug":"metrics","depth":2,"children":[]},{"title":"Public IP Reporting","slug":"public-ip-reporting","depth":2,"children":[]},{"title":"Diagnostics","slug":"diagnostics","depth":2,"children":[]},{"title":"Advanced Environment Tuning","slug":"advanced-environment-tuning","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"ankra","siteName":"Ankra","title":"Agent Helm Values - Ankra","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-16T17:35:28.999Z","originalFileLocation":"reference/agent-helm-values.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Every configurable value of the ankra-agent Helm chart - workers, pipelines, watch tuning, logs, metrics, security contexts and rollout.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Ankra\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ankra/POmNwpWKiefNAN49/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/ankra/POmNwpWKiefNAN49/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ankra/POmNwpWKiefNAN49/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/ankra/POmNwpWKiefNAN49/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/ankra/POmNwpWKiefNAN49/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ankra/POmNwpWKiefNAN49/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ankra/POmNwpWKiefNAN49/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/ankra/POmNwpWKiefNAN49/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/ankra/POmNwpWKiefNAN49/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Agent Helm Values - Ankra\">\u003cmeta data-mint-head property=\"og:description\" content=\"Every configurable value of the ankra-agent Helm chart - workers, pipelines, watch tuning, logs, metrics, security contexts and rollout.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Ankra\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.ankra.ai/reference/agent-helm-values\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://ankra.mintlify.site/_mintlify/api/og/v2?division=Reference\u0026amp;title=Agent+Helm+Values\u0026amp;description=Every+configurable+value+of+the+ankra-agent+Helm+chart+-+workers%2C+pipelines%2C+watch+tuning%2C+logs%2C+metrics%2C+security+contexts+and+rollout.\u0026amp;theme=66127f62fb825da5e40c577a\u0026amp;signature=cf794aaa9825e22764b407316eae4cfb98c966d9a011dec6afcee050e95bd592\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Agent Helm Values - Ankra\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Every configurable value of the ankra-agent Helm chart - workers, pipelines, watch tuning, logs, metrics, security contexts and rollout.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ankra.mintlify.site/_mintlify/api/og/v2?division=Reference\u0026amp;title=Agent+Helm+Values\u0026amp;description=Every+configurable+value+of+the+ankra-agent+Helm+chart+-+workers%2C+pipelines%2C+watch+tuning%2C+logs%2C+metrics%2C+security+contexts+and+rollout.\u0026amp;theme=66127f62fb825da5e40c577a\u0026amp;signature=cf794aaa9825e22764b407316eae4cfb98c966d9a011dec6afcee050e95bd592\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/ankra/POmNwpWKiefNAN49/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Ankra\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#5d64ff\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.ankra.ai/reference/agent-helm-values\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/reference/agent-helm-values.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.ankra.ai/#organization\",\"name\":\"Ankra\",\"url\":\"https://docs.ankra.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/ankra/uW749bPYey14eJsU/logo/light.svg?fit=max\u0026auto=format\u0026n=uW749bPYey14eJsU\u0026q=85\u0026s=7f48236f76559638a5a154da424c91d6\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.ankra.ai#website\",\"name\":\"Ankra\",\"url\":\"https://docs.ankra.ai\",\"publisher\":{\"@id\":\"https://docs.ankra.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.ankra.ai/reference/agent-helm-values#webpage\",\"url\":\"https://docs.ankra.ai/reference/agent-helm-values\",\"name\":\"Agent Helm Values\",\"description\":\"Every configurable value of the ankra-agent Helm chart - workers, pipelines, watch tuning, logs, metrics, security contexts and rollout.\",\"dateModified\":\"2026-11-16T17:35:28.999Z\",\"isPartOf\":{\"@id\":\"https://docs.ankra.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.ankra.ai/reference/agent-helm-values#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.ankra.ai/reference/agent-helm-values#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Reference\",\"item\":\"https://docs.ankra.ai/reference/cli\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Agent Helm Values\",\"item\":\"https://docs.ankra.ai/reference/agent-helm-values\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.ankra.ai/reference/agent-helm-values#article\",\"headline\":\"Agent Helm Values\",\"name\":\"Agent Helm Values\",\"description\":\"Every configurable value of the ankra-agent Helm chart - workers, pipelines, watch tuning, logs, metrics, security contexts and rollout.\",\"url\":\"https://docs.ankra.ai/reference/agent-helm-values\",\"mainEntityOfPage\":{\"@id\":\"https://docs.ankra.ai/reference/agent-helm-values#webpage\"},\"dateModified\":\"2026-11-16T17:35:28.999Z\",\"publisher\":{\"@id\":\"https://docs.ankra.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.ankra.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Ankra\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Ankra\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/reference/agent-helm-values.md","siteName":"Ankra","nav":{"global":{"anchors":[{"anchor":"Community","icon":"slack","href":"https://join.slack.com/t/ankra-community/shared_invite/zt-3a5rem8f8-cUho4epX2MoLT83bFf~VSA"},{"anchor":"Youtube","icon":"youtube","href":"https://www.youtube.com/@ankraio"},{"anchor":"Blog","icon":"newspaper","href":"https://www.ankra.ai/blog"}]},"tabs":[{"tab":"Documentation","icon":"book","groups":[{"group":"Get Started","pages":[{"title":"Introduction","href":""},{"title":"Choose where to start","href":"/get-started/start-here"},{"title":"Connect your AI agent","href":"/get-started/connect-your-ai-agent"},{"title":"Try a playground","href":"/get-started/playground"},{"title":"Put your app online","href":"/get-started/put-your-app-online"},{"title":"Connect your own cluster","href":"/get-started/connect-your-cluster"},{"title":"Quickstart","href":"/get-started/quickstart"},{"title":"Guided Setup","href":"/get-started/guided-setup"},{"title":"Get started with Ankra CI","sidebarTitle":"Get started with Ankra CI","href":"/get-started/ankra-ci"},{"title":"Add a cluster","href":"/guides/import-cluster"},{"title":"Set up storage on a cluster you connect","sidebarTitle":"Storage on a cluster you connect","href":"/guides/storage-on-your-own-cluster"},{"title":"Bring an existing cluster under Ankra","sidebarTitle":"Bring an existing cluster","href":"/guides/adopt-an-existing-cluster"},{"title":"Import several clusters as code","sidebarTitle":"Import clusters as code","href":"/guides/import-clusters-as-code"},{"title":"Playground","href":"/guides/cluster-sandbox"},{"title":"Find your way around Ankra","sidebarTitle":"Find your way around","href":"/platform/find-your-way-around"},{"title":"Why was I refused?","href":"/guides/why-was-i-refused"}]},{"group":"Use Cases","pages":[{"title":"Production Multi-Cluster Platform","href":"/use-cases/production-multi-cluster-platform"},{"title":"From Prompt and Code to Production","href":"/use-cases/from-prompt-and-code-to-production"},{"title":"Prompt to Production","href":"/use-cases/prompt-to-production"},{"title":"Lovable to Ankra","href":"/use-cases/lovable-to-ankra"},{"title":"Vercel to Ankra","href":"/use-cases/vercel-to-ankra"},{"title":"Claude Code to Two Clusters","href":"/use-cases/claude-code-to-two-clusters"},{"title":"Speed Up CI","href":"/use-cases/speed-up-ci"},{"title":"Self-host an AI agent observability backend on-prem","href":"/use-cases/self-host-ai-agent-observability"}]},{"group":"Concepts","pages":[{"title":"How Ankra Works","href":"/concepts/how-ankra-works"},{"title":"Organisations \u0026 User Management","href":"/concepts/organisations"},{"title":"Projects","href":"/concepts/projects"},{"title":"CLI, MCP, API or Terraform","href":"/concepts/cli-mcp-api-terraform"},{"title":"Ankra Agent","href":"/concepts/cluster-agent"},{"title":"GitOps","href":"/concepts/gitops"},{"title":"Leaving Ankra","href":"/concepts/leaving-ankra"},{"title":"Stacks","href":"/concepts/stacks"},{"title":"Add-ons","href":"/concepts/addons"},{"title":"Chart sources","sidebarTitle":"Chart sources","href":"/concepts/chart-sources"},{"title":"Variables","href":"/concepts/variables"},{"title":"Deployment Engines","href":"/concepts/deployment-engines"},{"title":"Stack Profiles, Reusable Kubernetes Stack Templates","sidebarTitle":"Stack Profiles","href":"/concepts/stack-profiles"},{"title":"Applications","href":"/concepts/applications"},{"title":"Backup Vaults","href":"/concepts/backup-vaults"}]},{"group":"Create and Run Clusters","pages":[{"title":"Create a Cluster","href":"/guides/create-a-cluster"},{"group":"Ankra Managed","pages":[{"title":"Hetzner Clusters","href":"/guides/hetzner-clusters"},{"title":"OVH Clusters","href":"/guides/ovh-clusters"},{"title":"UpCloud Clusters","href":"/guides/upcloud-clusters"},{"title":"DigitalOcean Clusters","href":"/guides/digitalocean-clusters"},{"title":"Scaleway Clusters","tag":"Closed Beta","href":"/guides/scaleway-clusters"},{"title":"AWS Clusters","icon":"aws","href":"/guides/aws-clusters"},{"title":"Ankra Cloud Clusters","icon":"cloud","tag":"Closed Beta","href":"/guides/ankra-cloud-clusters"},{"title":"Ankra Cloud Servers, Disks and Quota","tag":"Closed Beta","href":"/guides/ankra-cloud-servers-and-disks"},{"title":"Proxmox VE Clusters","href":"/guides/proxmox-clusters"},{"title":"Persistent Volumes on Proxmox VE Clusters","icon":"hard-drive","href":"/guides/proxmox-persistent-volumes"},{"title":"Morpheus Clusters","tag":"Closed Beta","href":"/guides/morpheus-clusters"},{"title":"Operate an Ankra Managed Cluster","href":"/guides/operate-ankra-managed-clusters"},{"title":"Gateway API","href":"/guides/gateway-api"},{"title":"Cluster Autoscaling","href":"/guides/cluster-autoscaling"},{"title":"Node Group Cloud-init User Data","href":"/guides/node-group-user-data"}]},{"group":"Cloud Managed","pages":[{"title":"Managed Kubernetes","href":"/guides/managed-kubernetes"},{"title":"DigitalOcean Kubernetes (DOKS)","icon":"digital-ocean","href":"/guides/doks-clusters"},{"title":"UpCloud Kubernetes (UKS)","icon":"cloud","href":"/guides/uks-clusters"},{"title":"Google Kubernetes Engine (GKE)","icon":"google","href":"/guides/gke-clusters"},{"title":"OVHcloud Managed Kubernetes (MKS)","icon":"cloud","href":"/guides/ovh-mks-clusters"},{"title":"Azure Kubernetes Service (AKS)","icon":"microsoft","href":"/guides/aks-clusters"},{"title":"Amazon EKS","icon":"aws","href":"/guides/eks-clusters"},{"title":"Ankra Cloud Kubernetes","icon":"cloud","tag":"Closed Beta","href":"/guides/ankra-cloud-kubernetes"}]},{"title":"A cluster or node that will not come up","sidebarTitle":"Cluster will not come up","href":"/guides/cluster-will-not-come-up"},{"group":"Operate","pages":[{"title":"Cluster Settings","href":"/platform/cluster-settings"},{"title":"Read a cluster's overview and health","sidebarTitle":"Overview and health","href":"/platform/cluster-overview-and-health"},{"title":"Manage Nodes and Node Groups","sidebarTitle":"Nodes","href":"/platform/cluster-nodes"},{"title":"Stop, Start and Power Schedules","href":"/platform/cluster-power-schedules"},{"title":"Upgrade Kubernetes on a Cluster","href":"/guides/kubernetes-upgrades"},{"title":"OS Security Patching","href":"/guides/os-patching"},{"title":"Clone a Cluster","href":"/guides/clone-cluster"},{"title":"Rename a Cluster","href":"/guides/rename-cluster"},{"title":"Cluster Mesh","tag":"Closed Beta","href":"/platform/cluster-mesh"},{"title":"Verify a Cluster Mesh","tag":"Closed Beta","href":"/guides/cluster-mesh-verification"}]},{"title":"Connect a Local minikube Cluster","href":"/guides/minikube"},{"title":"Talos Linux Clusters","sidebarTitle":"Talos Linux","href":"/guides/talos-clusters"}]},{"group":"Ship Your App","pages":[{"title":"Ship Your App","sidebarTitle":"Pick a Route","href":"/guides/deliver-your-app"},{"group":"Applications","pages":[{"title":"Flow Parity Matrix","href":"/reference/flow-parity"},{"title":"The application page","href":"/platform/application-page"},{"title":"Environments and Branch Rules","sidebarTitle":"Environments and Branch Rules","href":"/guides/application-environments"},{"title":"Roll back an application","href":"/guides/roll-back-an-application"},{"title":"Application CI/CD","href":"/guides/cicd-pipeline"},{"title":"Harbor as your application registry","href":"/guides/harbor-registry"},{"title":"From Claude Design to a live application","href":"/guides/claude-design-to-ankra"}]},{"group":"Managed Services","pages":[{"title":"Managed Services","tag":"Closed Beta","href":"/concepts/managed-services"},{"title":"Set Up a Managed Service","tag":"Closed Beta","href":"/guides/set-up-a-managed-service"},{"title":"Connect to a Managed Service","tag":"Closed Beta","href":"/guides/connect-to-a-managed-service"},{"title":"Disconnect an Application from a Managed Service","tag":"Closed Beta","href":"/guides/disconnect-an-application-from-a-managed-service"},{"title":"Delete a Managed Service","tag":"Closed Beta","href":"/guides/delete-a-managed-service"},{"title":"Publish a Managed Service","tag":"Closed Beta","href":"/guides/publish-a-managed-service"},{"title":"Managed Service Settings","tag":"Closed Beta","href":"/reference/managed-services"}]},{"group":"Previews","pages":[{"title":"PR Preview Environments","href":"/guides/pr-preview-environments"},{"title":"Preview a branch","href":"/guides/branch-demos"},{"title":"Stack Profile Demos","href":"/guides/stack-profile-demos"}]},{"group":"Bring Your Own CI","pages":[{"title":"GitLab CI/CD Pipeline","href":"/guides/gitlab-cicd-pipeline"},{"title":"Use the ankra CLI in CI","href":"/guides/pipeline-agents"}]},{"group":"Move From Docker","pages":[{"title":"Move a Docker Deployment Into a Cluster","href":"/guides/migrate-from-docker"},{"title":"Write an ankra migrate Module","href":"/guides/migrate-modules"}]}]},{"group":"Ankra Pipelines","pages":[{"title":"Ankra Pipelines","sidebarTitle":"Overview","href":"/pipelines/overview"},{"title":"Why Ankra Pipelines","sidebarTitle":"Why Ankra Pipelines","href":"/pipelines/why-ankra-pipelines"},{"title":"How Ankra Pipelines works","sidebarTitle":"How it works","href":"/pipelines/how-it-works"},{"title":"Where your pipeline runs and what it costs","sidebarTitle":"Where pipelines run","href":"/pipelines/where-pipelines-run"},{"title":"Generated pipelines","sidebarTitle":"Generated pipelines","href":"/pipelines/generated-pipelines"},{"title":"Pipeline examples","sidebarTitle":"Examples","href":"/pipelines/examples"},{"title":"Deploy on merge from an Ankra pipeline","sidebarTitle":"Deploy on merge","href":"/pipelines/deploy-on-merge"},{"group":"Speed","pages":[{"title":"Fast CI","sidebarTitle":"Fast CI","href":"/pipelines/fast-ci"},{"title":"Pipeline caching","sidebarTitle":"Caching","href":"/pipelines/caching"},{"title":"The merge train","sidebarTitle":"Merge train","href":"/pipelines/merge-train"}]},{"group":"AI","pages":[{"title":"AI in pull requests","sidebarTitle":"AI in pull requests","href":"/pipelines/ai-in-pull-requests"},{"title":"AI Gateway","sidebarTitle":"AI Gateway","href":"/pipelines/ai-gateway"},{"title":"Pipelines with Claude Code, Codex and the Claude app","sidebarTitle":"With coding agents","href":"/pipelines/coding-agents"}]},{"title":"Pipelines from the CLI and MCP","sidebarTitle":"CLI and MCP","href":"/pipelines/cli-and-mcp"},{"group":"Set Up and Operate","pages":[{"title":"Set up and run Ankra Pipelines","sidebarTitle":"Ankra Pipelines","href":"/guides/ankra-pipelines"},{"title":"Ankra CI starter pipelines","sidebarTitle":"Starter pipelines","href":"/guides/ankra-ci-starter-pipelines"},{"title":"Build a Bazel Repository with Ankra Pipelines","sidebarTitle":"Bazel","href":"/guides/bazel-pipelines"},{"title":"Move to Ankra Pipelines","sidebarTitle":"Move to Ankra Pipelines","href":"/guides/migrate-from-github-actions"},{"title":"Run tests and lint in Ankra Workspaces","sidebarTitle":"Workspaces","href":"/guides/ankra-workspaces"},{"title":"Offload Claude Code build sessions to Ankra Workspaces","sidebarTitle":"Claude Code on Workspaces","href":"/guides/claude-code-workspaces"},{"title":"Ankra CI troubleshooting","sidebarTitle":"Troubleshooting","href":"/guides/ankra-ci-troubleshooting"}]},{"title":"pipeline.yaml reference","href":"/guides/pipeline-reference"}]},{"group":"Stacks and Add-ons","pages":[{"title":"Build a monitoring Stack","href":"/guides/monitoring-stack"},{"title":"Expose services with a Cloudflare Tunnel Stack","href":"/guides/cloudflare-tunnel"},{"title":"Use Avura domains with Ankra","href":"/guides/avura-domains"},{"title":"Use your own domain","href":"/guides/use-your-own-domain"},{"title":"Clone Stacks Between Clusters and Organisations","sidebarTitle":"Clone Stacks","href":"/guides/clone-stack"},{"title":"Migrate from Argo CD","href":"/guides/migrate-from-argo-cd"},{"title":"Protect Persistent Data Before Changing a Stack","href":"/guides/protect-persistent-data"},{"title":"Stack Profile Suggestions","href":"/guides/stack-profile-suggestions"},{"title":"Create and change a stack","sidebarTitle":"Create and change a stack","href":"/guides/create-and-change-a-stack"},{"title":"Undo a change with stack history","sidebarTitle":"Stack history and restore","href":"/guides/stack-history-and-restore"},{"group":"Add-on Catalog","pages":[{"title":"Charts and the add-on catalogue","sidebarTitle":"Add-on catalogue","href":"/platform/addon-catalog"},{"title":"Connect a Helm registry","sidebarTitle":"Connect a Helm Registry","href":"/guides/registries"},{"title":"Create a Registry","href":"/guides/create-a-registry"},{"title":"Publishing Add-ons","href":"/platform/addon-publishing"},{"title":"Publishing Applications as Add-ons","href":"/platform/application-addons"}]}]},{"group":"Observe and Troubleshoot","pages":[{"title":"Home","href":"/platform/home"},{"title":"Troubleshoot a Cluster","href":"/guides/troubleshoot-a-cluster"},{"title":"Troubleshooting by Symptom","href":"/guides/troubleshooting"},{"title":"Notifications and Needs you","href":"/platform/activity-inbox"},{"title":"Find out why a deploy failed and retry it","sidebarTitle":"Operations","href":"/platform/operations"},{"title":"Cluster metrics","href":"/platform/cluster-metrics"},{"title":"Prometheus","href":"/integrations/prometheus"},{"title":"Logs","href":"/platform/logs"},{"title":"Ankra Hosted Logs","href":"/guides/hosted-logs"},{"title":"Log Sources","href":"/integrations/log-sources"},{"group":"Kubernetes Resources","pages":[{"title":"Kubernetes Resources","sidebarTitle":"Overview","href":"/platform/kubernetes-insights"},{"title":"Kubernetes nodes","href":"/platform/kubernetes-nodes"},{"title":"Pod Terminal for Kubernetes in Your Browser","sidebarTitle":"Pod Terminal","href":"/platform/pod-terminal"},{"title":"Debug Pods","href":"/platform/debug-pods"}]},{"group":"Alerts and Notifications","pages":[{"title":"Get the right notifications to the right people","sidebarTitle":"Notifications end to end","href":"/guides/notifications-to-the-right-people"},{"title":"Alerts","href":"/guides/alerts"},{"title":"Send your Alertmanager alerts to Ankra","sidebarTitle":"Alertmanager to Ankra","href":"/guides/alertmanager-to-ankra"},{"title":"Notification routing","href":"/guides/notification-routing"},{"title":"Webhooks","href":"/guides/webhooks"},{"title":"Alert in Slack when a manifest fails to deploy","sidebarTitle":"Alert on manifest failures","href":"/guides/webhook-integrations"},{"title":"Push notifications on your phone","sidebarTitle":"Mobile push notifications","href":"/guides/mobile-push"}]}]},{"group":"Ankra AI","pages":[{"title":"Ankra AI","sidebarTitle":"Overview","href":"/platform/ai-overview"},{"group":"Use It","pages":[{"title":"Set up the AI Gateway","sidebarTitle":"Gateway setup","href":"/platform/ai-guided-setup"},{"title":"AI Assistant","href":"/platform/ai-assistant"},{"title":"Ankra AI on call in Slack or Microsoft Teams","sidebarTitle":"Ankra AI on call in chat","href":"/guides/ai-on-call-in-chat"},{"title":"Save, Share and Publish Canvases","sidebarTitle":"Canvases","href":"/platform/canvases"},{"title":"AI Insights","href":"/platform/ai-insights"},{"title":"Troubleshooting Ankra AI","sidebarTitle":"Troubleshooting Ankra AI","href":"/guides/troubleshooting-ankra-ai"}]},{"group":"Agents and Board","pages":[{"title":"AI agents","href":"/platform/ai-agents"},{"title":"Follow, steer and stop an agent run","sidebarTitle":"Follow an agent run","href":"/guides/agent-runs"},{"title":"AI Board","href":"/platform/ai-board"},{"title":"Set up the ticket desk and work tickets with the Ankra agent","sidebarTitle":"Set up the ticket desk","href":"/guides/ticket-desk"},{"title":"Work the AI Board with Your Own Agent","href":"/guides/board-own-agent"},{"title":"AI automations","href":"/platform/ai-automations"},{"title":"Watch for a problem and decide what Ankra does","sidebarTitle":"Watch for a problem","href":"/guides/ai-watching"},{"title":"AI Autonomy","href":"/platform/ai-autonomy"},{"title":"Sync Board Tickets to Jira, Linear, or a Webhook","href":"/guides/ticket-sync"},{"title":"AI Workspaces","href":"/platform/ai-workspaces"}]},{"group":"Code Review","pages":[{"title":"AI Code Review","href":"/platform/ai-code-review"},{"title":"Cross-Repository Review","href":"/platform/ai-code-review-cross-repo"},{"title":"Application AI Settings","href":"/platform/application-ai"},{"title":"Teach Your Agents with AGENTS.md","href":"/platform/agents-md"}]},{"group":"Configure","pages":[{"title":"Models and Cost","href":"/platform/ai-provider"},{"title":"Your Own AI Keys","href":"/platform/personal-ai-keys"},{"title":"Bring Your Own OpenRouter API Key","href":"/guides/openrouter-api-key"},{"title":"AI Connections","href":"/platform/ai-connections"},{"title":"AI Skills and Custom Tools","href":"/platform/ai-skills"},{"title":"AI Memory and Feedback","href":"/platform/ai-memory"}]}]},{"group":"Connect Tools","pages":[{"title":"Ankra CLI","href":"/integrations/ankra-cli"},{"title":"Script the Ankra CLI","href":"/guides/script-the-cli"},{"title":"MCP Server","href":"/platform/mcp-server"},{"title":"MCP Tool Reference","href":"/platform/mcp-tools"},{"title":"Agent Skills","href":"/integrations/agent-skills"},{"title":"Agent Skills Catalogue","href":"/integrations/agent-skills-catalogue"},{"title":"OpenClaw","href":"/integrations/openclaw"},{"title":"Ankra Terraform Provider","href":"/integrations/terraform"}]},{"group":"Source Control","pages":[{"title":"Git Providers","href":"/integrations/git-providers"},{"title":"GitHub Integration","href":"/integrations/github"},{"title":"GitLab Integration","href":"/integrations/gitlab"},{"title":"Bitbucket Cloud Integration","href":"/integrations/bitbucket-cloud"}]},{"group":"Security and Access","pages":[{"title":"What Ankra Can See and Do","sidebarTitle":"Security overview","href":"/security/overview"},{"title":"Cluster security","href":"/guides/cluster-security"},{"title":"Fix a vulnerable image with a pull request","href":"/guides/fix-a-vulnerable-image"},{"title":"Security reports","href":"/guides/security-reports"},{"group":"Access","pages":[{"title":"Identity \u0026 Access Controls","href":"/security/identity-and-access"},{"title":"Single sign-on","href":"/guides/single-sign-on"},{"title":"Roles \u0026 Access","href":"/guides/roles-and-access"},{"title":"Set Up Projects","href":"/guides/set-up-projects"},{"title":"Private access for proxied domains","href":"/guides/private-proxied-domains"},{"title":"Protect a tunnel with Ankra sign-in","href":"/guides/protect-a-tunnel-with-ankra-sign-in"},{"title":"Account security and two-step sign-in","href":"/platform/account-security"},{"title":"Service Tokens","href":"/guides/service-tokens"},{"title":"Give a Coding Agent Least Privilege","href":"/guides/least-privilege-for-coding-agents"},{"title":"API Tokens","href":"/reference/tokens"},{"title":"Cluster Access","href":"/guides/cluster-access"},{"title":"Accessing Clusters with kubectl","href":"/guides/kubeconfig"},{"title":"Ankra Support Access","href":"/security/support-access"}]},{"group":"Hardening","pages":[{"title":"Cluster Hardening","href":"/security/hardening"},{"title":"Hardening the Agent","href":"/security/agent-hardening"},{"title":"Verified Provenance at Deploy","href":"/security/deploy-provenance"},{"title":"SOPS encryption","href":"/guides/sops"},{"title":"Organisation Secrets","href":"/guides/organisation-secrets"}]},{"group":"Compliance and Audit","pages":[{"title":"Shared Responsibility","href":"/security/shared-responsibility"},{"title":"Compliance Management","href":"/security/compliance-management"},{"title":"Audit-Ready Evidence for ISO 27001 and SOC 2","sidebarTitle":"Audit-ready evidence","href":"/security/audit-ready"},{"title":"Change Management","href":"/security/change-management"},{"title":"Audit Log","href":"/guides/audit-log"},{"title":"Audit Export","href":"/security/audit-export"},{"title":"Agent Compliance Posture","href":"/security/agent-compliance"}]}]},{"group":"Cost and Backups","pages":[{"title":"Cloud Cost","href":"/platform/cloud-cost"},{"title":"Cost Budgets and the Autopilot","href":"/guides/cost-budgets-and-autopilot"},{"title":"Find out why your bill went up, and bring it down","sidebarTitle":"Find out why your bill went up","href":"/guides/find-why-your-bill-went-up"},{"title":"Backups and Restore Points","href":"/guides/backups"},{"title":"Run a restore drill","sidebarTitle":"Run a restore drill","href":"/guides/restore-drill"},{"title":"Object Storage Buckets","href":"/guides/object-storage-buckets"}]},{"group":"Organisation and Account","pages":[{"title":"Organisation settings","href":"/platform/organisation-settings"},{"title":"Leave or delete an organisation","href":"/guides/delete-or-leave-an-organisation"},{"group":"Credentials","pages":[{"title":"Credentials","href":"/platform/credentials"},{"title":"Git Credentials","icon":"code-branch","href":"/platform/credentials/git"},{"title":"Registry Credentials","icon":"box","href":"/platform/credentials/registry"},{"title":"Hetzner API Credentials","icon":"cloud","href":"/platform/credentials/hetzner"},{"title":"OVH API Credentials","icon":"cloud","href":"/platform/credentials/ovh"},{"title":"UpCloud API Credentials","icon":"cloud","href":"/platform/credentials/upcloud"},{"title":"DigitalOcean API Credentials","icon":"digital-ocean","href":"/platform/credentials/digitalocean"},{"title":"Scaleway Credentials","icon":"cloud","tag":"Closed Beta","href":"/platform/credentials/scaleway"},{"title":"AWS Credentials","icon":"aws","href":"/platform/credentials/aws"},{"title":"Google Cloud (GCP) Credentials","icon":"google","href":"/platform/credentials/gcp"},{"title":"Azure Credentials","icon":"microsoft","href":"/platform/credentials/azure"},{"title":"Proxmox VE API Credentials","icon":"server","href":"/platform/credentials/proxmox"},{"title":"Morpheus API Credentials","icon":"server","tag":"Closed Beta","href":"/platform/credentials/morpheus"},{"title":"Ankra Cloud Credentials","icon":"cloud","tag":"Closed Beta","href":"/platform/credentials/ankra-cloud"},{"title":"SSH Key Credentials","icon":"lock","href":"/platform/credentials/ssh-key"}]},{"title":"Billing and usage","href":"/platform/billing"},{"title":"Pricing explained","href":"/platform/pricing-explained"},{"title":"Usage","href":"/platform/usage"},{"title":"Your account","href":"/platform/user-profile"},{"title":"Connect your Git provider and your own accounts","href":"/platform/connected-accounts"},{"title":"Find","href":"/platform/command-palette"},{"title":"Keyboard shortcuts","href":"/platform/keyboard-shortcuts"},{"title":"Support","href":"/platform/support"}]},{"group":"Reference","pages":[{"group":"CLI","pages":[{"title":"CLI Command Reference","href":"/reference/cli/index"},{"title":"ankra agents","href":"/reference/cli/agents"},{"title":"ankra ai","href":"/reference/cli/ai"},{"title":"ankra alerts","href":"/reference/cli/alerts"},{"title":"ankra application","href":"/reference/cli/application"},{"title":"ankra backup","href":"/reference/cli/backup"},{"title":"ankra bucket","href":"/reference/cli/bucket"},{"title":"ankra canvas","href":"/reference/cli/canvas"},{"title":"ankra charts","href":"/reference/cli/charts"},{"title":"ankra chat","href":"/reference/cli/chat"},{"title":"ankra cluster","href":"/reference/cli/cluster"},{"title":"ankra completion","href":"/reference/cli/completion"},{"title":"ankra config","href":"/reference/cli/config"},{"title":"ankra cost","href":"/reference/cli/cost"},{"title":"ankra credentials","href":"/reference/cli/credentials"},{"title":"ankra delete","href":"/reference/cli/delete"},{"title":"ankra deployments","href":"/reference/cli/deployments"},{"title":"ankra dev","href":"/reference/cli/dev"},{"title":"ankra exec","href":"/reference/cli/exec"},{"title":"ankra helm","href":"/reference/cli/helm"},{"title":"ankra login","href":"/reference/cli/login"},{"title":"ankra logout","href":"/reference/cli/logout"},{"title":"ankra mcp","href":"/reference/cli/mcp"},{"title":"ankra migrate","href":"/reference/cli/migrate"},{"title":"ankra onboard","href":"/reference/cli/onboard"},{"title":"ankra openclaw","href":"/reference/cli/openclaw"},{"title":"ankra org","href":"/reference/cli/org"},{"title":"ankra pipeline","href":"/reference/cli/pipeline"},{"title":"ankra plugins","href":"/reference/cli/plugins"},{"title":"ankra profile","href":"/reference/cli/profile"},{"title":"ankra project","href":"/reference/cli/project"},{"title":"ankra registry","href":"/reference/cli/registry"},{"title":"ankra runs","href":"/reference/cli/runs"},{"title":"ankra secrets","href":"/reference/cli/secrets"},{"title":"ankra security","href":"/reference/cli/security"},{"title":"ankra services","href":"/reference/cli/services"},{"title":"ankra skills","href":"/reference/cli/skills"},{"title":"ankra slack","href":"/reference/cli/slack"},{"title":"ankra stack-profiles","href":"/reference/cli/stack-profiles"},{"title":"ankra support","href":"/reference/cli/support"},{"title":"ankra targets","href":"/reference/cli/targets"},{"title":"ankra tickets","href":"/reference/cli/tickets"},{"title":"ankra tokens","href":"/reference/cli/tokens"},{"title":"ankra upgrade","href":"/reference/cli/upgrade"},{"title":"ankra workspace","href":"/reference/cli/workspace"}]},{"title":"ImportCluster YAML Schema","href":"/reference/importcluster"},{"title":"Glossary","href":"/reference/glossary"},{"title":"ankra.yaml reference","description":"Every key of .ankra/ankra.yaml, the application descriptor - metadata, the deploy options that drive the deploy form, the components block that declares a monorepo's deployable apps, and the health block the readiness gate reads.","href":"/reference/application-descriptor"},{"title":"Agent Helm Values","href":"/reference/agent-helm-values"},{"title":"Add-on Settings","description":"Configure sync policies, retry behaviour, health checks, and ignore rules for your add-ons.","href":"/concepts/addon-settings"},{"title":"Cost API fields","href":"/reference/cost-api"},{"title":"Portal URLs","href":"/platform/portal-urls"},{"title":"Where did it go? Classic paths in the Ankra portal","sidebarTitle":"Where did it go?","href":"/platform/classic-to-portal"},{"group":"Providers","pages":[{"title":"Hetzner Reference","href":"/reference/hetzner"},{"title":"OVH Reference","href":"/reference/ovh"},{"title":"UpCloud Reference","href":"/reference/upcloud"},{"title":"DigitalOcean Reference","href":"/reference/digitalocean"},{"title":"AWS Reference","href":"/reference/aws"},{"title":"Proxmox VE Reference","href":"/reference/proxmox"},{"title":"Morpheus Reference","tag":"Closed Beta","href":"/reference/morpheus"},{"title":"Managed Kubernetes Reference","href":"/reference/managed-kubernetes"}]}]}]},{"tab":"API Reference","icon":"terminal","pages":[{"title":"API Reference","href":"/api-reference/introduction"}]},{"tab":"Changelog","icon":"clock-rotate-left","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"Agent Helm Values - Ankra","buildId":"dpl_4D8r1dHg6bQcRuBgQyL3z9waJJtn","deploymentId":"dpl_4D8r1dHg6bQcRuBgQyL3z9waJJtn","dynamics":[],"chunks":[]}