From d4d52df9ed7c401803d1883b669a76a302f723c0 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Wed, 29 Apr 2026 04:17:58 +0000 Subject: [PATCH] [docs] Update managed apps reference for v1.3 2026-04-29 04:17:58 Signed-off-by: github-actions[bot] --- .../en/docs/v1.3/applications/clickhouse.md | 2 +- .../en/docs/v1.3/applications/foundationdb.md | 2 +- content/en/docs/v1.3/applications/harbor.md | 2 +- content/en/docs/v1.3/applications/kafka.md | 2 +- content/en/docs/v1.3/applications/mariadb.md | 2 +- content/en/docs/v1.3/applications/mongodb.md | 2 +- content/en/docs/v1.3/applications/nats.md | 2 +- content/en/docs/v1.3/applications/openbao.md | 2 +- content/en/docs/v1.3/applications/postgres.md | 15 +++--- content/en/docs/v1.3/applications/qdrant.md | 2 +- content/en/docs/v1.3/applications/rabbitmq.md | 2 +- content/en/docs/v1.3/applications/redis.md | 2 +- content/en/docs/v1.3/applications/tenant.md | 2 +- content/en/docs/v1.3/kubernetes/_index.md | 54 ++++++++++--------- content/en/docs/v1.3/networking/http-cache.md | 2 +- .../en/docs/v1.3/networking/tcp-balancer.md | 2 +- content/en/docs/v1.3/networking/vpc.md | 2 +- content/en/docs/v1.3/networking/vpn.md | 2 +- .../docs/v1.3/operations/services/bootbox.md | 2 +- .../en/docs/v1.3/operations/services/etcd.md | 2 +- .../docs/v1.3/operations/services/ingress.md | 16 +++++- .../services/monitoring/parameters.md | 2 +- .../v1.3/operations/services/seaweedfs.md | 2 +- .../en/docs/v1.3/virtualization/vm-disk.md | 2 +- .../docs/v1.3/virtualization/vm-instance.md | 53 +++++++++--------- 25 files changed, 99 insertions(+), 81 deletions(-) diff --git a/content/en/docs/v1.3/applications/clickhouse.md b/content/en/docs/v1.3/applications/clickhouse.md index 99d4c161..bff41f87 100644 --- a/content/en/docs/v1.3/applications/clickhouse.md +++ b/content/en/docs/v1.3/applications/clickhouse.md @@ -11,7 +11,7 @@ aliases: diff --git a/content/en/docs/v1.3/applications/foundationdb.md b/content/en/docs/v1.3/applications/foundationdb.md index 8faec7cc..362fe08a 100644 --- a/content/en/docs/v1.3/applications/foundationdb.md +++ b/content/en/docs/v1.3/applications/foundationdb.md @@ -6,7 +6,7 @@ weight: 50 diff --git a/content/en/docs/v1.3/applications/harbor.md b/content/en/docs/v1.3/applications/harbor.md index c21a59dc..26e43e56 100644 --- a/content/en/docs/v1.3/applications/harbor.md +++ b/content/en/docs/v1.3/applications/harbor.md @@ -7,7 +7,7 @@ weight: 50 diff --git a/content/en/docs/v1.3/applications/kafka.md b/content/en/docs/v1.3/applications/kafka.md index 08012650..0f45e8bb 100644 --- a/content/en/docs/v1.3/applications/kafka.md +++ b/content/en/docs/v1.3/applications/kafka.md @@ -10,7 +10,7 @@ aliases: diff --git a/content/en/docs/v1.3/applications/mariadb.md b/content/en/docs/v1.3/applications/mariadb.md index 23acdb56..66ab2298 100644 --- a/content/en/docs/v1.3/applications/mariadb.md +++ b/content/en/docs/v1.3/applications/mariadb.md @@ -10,7 +10,7 @@ aliases: diff --git a/content/en/docs/v1.3/applications/mongodb.md b/content/en/docs/v1.3/applications/mongodb.md index 1407b6bd..a3a749d4 100644 --- a/content/en/docs/v1.3/applications/mongodb.md +++ b/content/en/docs/v1.3/applications/mongodb.md @@ -10,7 +10,7 @@ aliases: diff --git a/content/en/docs/v1.3/applications/nats.md b/content/en/docs/v1.3/applications/nats.md index daf1dcb1..687bc655 100644 --- a/content/en/docs/v1.3/applications/nats.md +++ b/content/en/docs/v1.3/applications/nats.md @@ -10,7 +10,7 @@ aliases: diff --git a/content/en/docs/v1.3/applications/openbao.md b/content/en/docs/v1.3/applications/openbao.md index 367aaf19..11d6c590 100644 --- a/content/en/docs/v1.3/applications/openbao.md +++ b/content/en/docs/v1.3/applications/openbao.md @@ -7,7 +7,7 @@ weight: 50 diff --git a/content/en/docs/v1.3/applications/postgres.md b/content/en/docs/v1.3/applications/postgres.md index 22b1fbcd..27434aac 100644 --- a/content/en/docs/v1.3/applications/postgres.md +++ b/content/en/docs/v1.3/applications/postgres.md @@ -10,7 +10,7 @@ aliases: @@ -147,12 +147,13 @@ See: ### Bootstrap (recovery) parameters -| Name | Description | Type | Value | -| ------------------------ | ------------------------------------------------------------------- | -------- | ------- | -| `bootstrap` | Bootstrap configuration. | `object` | `{}` | -| `bootstrap.enabled` | Whether to restore from a backup. | `bool` | `false` | -| `bootstrap.recoveryTime` | Timestamp (RFC3339) for point-in-time recovery; empty means latest. | `string` | `""` | -| `bootstrap.oldName` | Previous cluster name before deletion. | `string` | `""` | +| Name | Description | Type | Value | +| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ------- | +| `bootstrap` | Bootstrap configuration. | `object` | `{}` | +| `bootstrap.enabled` | Whether to restore from a backup. | `bool` | `false` | +| `bootstrap.recoveryTime` | Timestamp (RFC3339) for point-in-time recovery; empty means latest. | `string` | `""` | +| `bootstrap.oldName` | Previous cluster name before deletion. | `string` | `""` | +| `bootstrap.serverName` | Barman server name (S3 path prefix) used by the original cluster when writing backups. Set this only when the original cluster had an explicit barmanObjectStore.serverName that differed from its Kubernetes resource name. | `string` | `""` | ## Parameter examples and reference diff --git a/content/en/docs/v1.3/applications/qdrant.md b/content/en/docs/v1.3/applications/qdrant.md index faed70d7..9580e854 100644 --- a/content/en/docs/v1.3/applications/qdrant.md +++ b/content/en/docs/v1.3/applications/qdrant.md @@ -7,7 +7,7 @@ weight: 50 diff --git a/content/en/docs/v1.3/applications/rabbitmq.md b/content/en/docs/v1.3/applications/rabbitmq.md index 589524fe..856f38e6 100644 --- a/content/en/docs/v1.3/applications/rabbitmq.md +++ b/content/en/docs/v1.3/applications/rabbitmq.md @@ -10,7 +10,7 @@ aliases: diff --git a/content/en/docs/v1.3/applications/redis.md b/content/en/docs/v1.3/applications/redis.md index 4cbc69ab..67415a53 100644 --- a/content/en/docs/v1.3/applications/redis.md +++ b/content/en/docs/v1.3/applications/redis.md @@ -10,7 +10,7 @@ aliases: diff --git a/content/en/docs/v1.3/applications/tenant.md b/content/en/docs/v1.3/applications/tenant.md index db87d35d..c23c67ea 100644 --- a/content/en/docs/v1.3/applications/tenant.md +++ b/content/en/docs/v1.3/applications/tenant.md @@ -10,7 +10,7 @@ aliases: diff --git a/content/en/docs/v1.3/kubernetes/_index.md b/content/en/docs/v1.3/kubernetes/_index.md index f6038b90..1b8c58f5 100644 --- a/content/en/docs/v1.3/kubernetes/_index.md +++ b/content/en/docs/v1.3/kubernetes/_index.md @@ -10,7 +10,7 @@ aliases: @@ -159,31 +159,33 @@ See the reference for components utilized in this service: ### Kubernetes Control Plane Configuration -| Name | Description | Type | Value | -| --------------------------------------------------- | ------------------------------------------------ | ---------- | ------- | -| `controlPlane` | Kubernetes control-plane configuration. | `object` | `{}` | -| `controlPlane.replicas` | Number of control-plane replicas. | `int` | `2` | -| `controlPlane.apiServer` | API Server configuration. | `object` | `{}` | -| `controlPlane.apiServer.resources` | CPU and memory resources for API Server. | `object` | `{}` | -| `controlPlane.apiServer.resources.cpu` | CPU available. | `quantity` | `""` | -| `controlPlane.apiServer.resources.memory` | Memory (RAM) available. | `quantity` | `""` | -| `controlPlane.apiServer.resourcesPreset` | Preset if `resources` omitted. | `string` | `large` | -| `controlPlane.controllerManager` | Controller Manager configuration. | `object` | `{}` | -| `controlPlane.controllerManager.resources` | CPU and memory resources for Controller Manager. | `object` | `{}` | -| `controlPlane.controllerManager.resources.cpu` | CPU available. | `quantity` | `""` | -| `controlPlane.controllerManager.resources.memory` | Memory (RAM) available. | `quantity` | `""` | -| `controlPlane.controllerManager.resourcesPreset` | Preset if `resources` omitted. | `string` | `micro` | -| `controlPlane.scheduler` | Scheduler configuration. | `object` | `{}` | -| `controlPlane.scheduler.resources` | CPU and memory resources for Scheduler. | `object` | `{}` | -| `controlPlane.scheduler.resources.cpu` | CPU available. | `quantity` | `""` | -| `controlPlane.scheduler.resources.memory` | Memory (RAM) available. | `quantity` | `""` | -| `controlPlane.scheduler.resourcesPreset` | Preset if `resources` omitted. | `string` | `micro` | -| `controlPlane.konnectivity` | Konnectivity configuration. | `object` | `{}` | -| `controlPlane.konnectivity.server` | Konnectivity Server configuration. | `object` | `{}` | -| `controlPlane.konnectivity.server.resources` | CPU and memory resources for Konnectivity. | `object` | `{}` | -| `controlPlane.konnectivity.server.resources.cpu` | CPU available. | `quantity` | `""` | -| `controlPlane.konnectivity.server.resources.memory` | Memory (RAM) available. | `quantity` | `""` | -| `controlPlane.konnectivity.server.resourcesPreset` | Preset if `resources` omitted. | `string` | `micro` | +| Name | Description | Type | Value | +| --------------------------------------------------- | --------------------------------------------------------------------------------------------- | ---------- | ------- | +| `controlPlane` | Kubernetes control-plane configuration. | `object` | `{}` | +| `controlPlane.replicas` | Number of control-plane replicas. | `int` | `2` | +| `controlPlane.apiServer` | API Server configuration. | `object` | `{}` | +| `controlPlane.apiServer.resources` | CPU and memory resources for API Server. | `object` | `{}` | +| `controlPlane.apiServer.resources.cpu` | CPU available. | `quantity` | `""` | +| `controlPlane.apiServer.resources.memory` | Memory (RAM) available. | `quantity` | `""` | +| `controlPlane.apiServer.resourcesPreset` | Preset if `resources` omitted. | `string` | `large` | +| `controlPlane.controllerManager` | Controller Manager configuration. | `object` | `{}` | +| `controlPlane.controllerManager.resources` | CPU and memory resources for Controller Manager. | `object` | `{}` | +| `controlPlane.controllerManager.resources.cpu` | CPU available. | `quantity` | `""` | +| `controlPlane.controllerManager.resources.memory` | Memory (RAM) available. | `quantity` | `""` | +| `controlPlane.controllerManager.resourcesPreset` | Preset if `resources` omitted. | `string` | `micro` | +| `controlPlane.scheduler` | Scheduler configuration. | `object` | `{}` | +| `controlPlane.scheduler.resources` | CPU and memory resources for Scheduler. | `object` | `{}` | +| `controlPlane.scheduler.resources.cpu` | CPU available. | `quantity` | `""` | +| `controlPlane.scheduler.resources.memory` | Memory (RAM) available. | `quantity` | `""` | +| `controlPlane.scheduler.resourcesPreset` | Preset if `resources` omitted. | `string` | `micro` | +| `controlPlane.konnectivity` | Konnectivity configuration. | `object` | `{}` | +| `controlPlane.konnectivity.server` | Konnectivity Server configuration. | `object` | `{}` | +| `controlPlane.konnectivity.server.resources` | CPU and memory resources for Konnectivity. | `object` | `{}` | +| `controlPlane.konnectivity.server.resources.cpu` | CPU available. | `quantity` | `""` | +| `controlPlane.konnectivity.server.resources.memory` | Memory (RAM) available. | `quantity` | `""` | +| `controlPlane.konnectivity.server.resourcesPreset` | Preset if `resources` omitted. | `string` | `micro` | +| `images` | Optional image overrides for air-gapped or rate-limited registries. | `object` | `{}` | +| `images.waitForKubeconfig` | Image used by the wait-for-kubeconfig init container. Empty falls back to images/busybox.tag. | `string` | `""` | ## Parameter examples and reference diff --git a/content/en/docs/v1.3/networking/http-cache.md b/content/en/docs/v1.3/networking/http-cache.md index 41a0588f..b45f5e4e 100644 --- a/content/en/docs/v1.3/networking/http-cache.md +++ b/content/en/docs/v1.3/networking/http-cache.md @@ -11,7 +11,7 @@ aliases: diff --git a/content/en/docs/v1.3/networking/tcp-balancer.md b/content/en/docs/v1.3/networking/tcp-balancer.md index 2f1d2b6d..be3c1b41 100644 --- a/content/en/docs/v1.3/networking/tcp-balancer.md +++ b/content/en/docs/v1.3/networking/tcp-balancer.md @@ -11,7 +11,7 @@ aliases: diff --git a/content/en/docs/v1.3/networking/vpc.md b/content/en/docs/v1.3/networking/vpc.md index 58ab71aa..4a7f6f7d 100644 --- a/content/en/docs/v1.3/networking/vpc.md +++ b/content/en/docs/v1.3/networking/vpc.md @@ -11,7 +11,7 @@ aliases: diff --git a/content/en/docs/v1.3/networking/vpn.md b/content/en/docs/v1.3/networking/vpn.md index d613e1cb..7525c5b3 100644 --- a/content/en/docs/v1.3/networking/vpn.md +++ b/content/en/docs/v1.3/networking/vpn.md @@ -11,7 +11,7 @@ aliases: diff --git a/content/en/docs/v1.3/operations/services/bootbox.md b/content/en/docs/v1.3/operations/services/bootbox.md index 642cd743..50b7b3ea 100644 --- a/content/en/docs/v1.3/operations/services/bootbox.md +++ b/content/en/docs/v1.3/operations/services/bootbox.md @@ -6,7 +6,7 @@ linkTitle: "BootBox" diff --git a/content/en/docs/v1.3/operations/services/etcd.md b/content/en/docs/v1.3/operations/services/etcd.md index 7b6860b1..abb254e9 100644 --- a/content/en/docs/v1.3/operations/services/etcd.md +++ b/content/en/docs/v1.3/operations/services/etcd.md @@ -6,7 +6,7 @@ linkTitle: "Etcd" diff --git a/content/en/docs/v1.3/operations/services/ingress.md b/content/en/docs/v1.3/operations/services/ingress.md index 2aafd4d2..09414b67 100644 --- a/content/en/docs/v1.3/operations/services/ingress.md +++ b/content/en/docs/v1.3/operations/services/ingress.md @@ -6,7 +6,7 @@ linkTitle: "Ingress" @@ -24,3 +24,17 @@ source: https://github.com/cozystack/cozystack/blob/v1.3.0/packages/extra/ingres | `resources.memory` | Memory (RAM) available to each replica. | `quantity` | `""` | | `resourcesPreset` | Default sizing preset used when `resources` is omitted. | `string` | `micro` | + +## Exposure mode + +The ingress Service type is driven by the cluster-wide `publishing.exposure` value in the platform chart, not by any key in this package. Two modes exist: + +- `externalIPs` (default) has three rendered shapes: + - Release namespace matches `publishing.ingressName` AND `publishing.externalIPs` is non-empty → Service is `ClusterIP` with `Service.spec.externalIPs` set from that list and `externalTrafficPolicy: Cluster`. + - Release namespace matches `publishing.ingressName` but `publishing.externalIPs` is empty → Service falls back to `type: LoadBalancer` with `externalTrafficPolicy: Local`. + - Release namespace does not match `publishing.ingressName` (non-root tenants) → Service is `type: LoadBalancer` with `externalTrafficPolicy: Local`. + `Service.spec.externalIPs` is deprecated upstream in Kubernetes v1.36 (KEP-5707); plan migration before v1.40. +- `loadBalancer` — Service is `type: LoadBalancer` with `externalTrafficPolicy: Local`, and a `CiliumLoadBalancerIPPool` makes the addresses in `publishing.externalIPs` allocatable via Cilium LB IPAM. Requires `publishing.externalIPs` to contain at least one non-empty address (render fails otherwise) and assumes the addresses are already routed to a cluster node (floating IP / upstream router). See the inline comment on `publishing.exposure` in the platform chart for full caveats, including the note that switching the value on a running cluster causes the ingress Service to be recreated. + +This setting only migrates ingress-nginx away from `Service.spec.externalIPs`. Other cozystack components that use the same deprecated field (e.g. the `vpn` app) must be migrated separately before Kubernetes v1.40 flips the `AllowServiceExternalIPs` feature gate off. + diff --git a/content/en/docs/v1.3/operations/services/monitoring/parameters.md b/content/en/docs/v1.3/operations/services/monitoring/parameters.md index 277df6c7..39a5d589 100644 --- a/content/en/docs/v1.3/operations/services/monitoring/parameters.md +++ b/content/en/docs/v1.3/operations/services/monitoring/parameters.md @@ -7,7 +7,7 @@ weight: 1 diff --git a/content/en/docs/v1.3/operations/services/seaweedfs.md b/content/en/docs/v1.3/operations/services/seaweedfs.md index 0f7fd4ff..19a220af 100644 --- a/content/en/docs/v1.3/operations/services/seaweedfs.md +++ b/content/en/docs/v1.3/operations/services/seaweedfs.md @@ -6,7 +6,7 @@ linkTitle: "SeaweedFS" diff --git a/content/en/docs/v1.3/virtualization/vm-disk.md b/content/en/docs/v1.3/virtualization/vm-disk.md index e67a30d5..5f9cca26 100644 --- a/content/en/docs/v1.3/virtualization/vm-disk.md +++ b/content/en/docs/v1.3/virtualization/vm-disk.md @@ -10,7 +10,7 @@ aliases: diff --git a/content/en/docs/v1.3/virtualization/vm-instance.md b/content/en/docs/v1.3/virtualization/vm-instance.md index 95c71eb8..29cda0ff 100644 --- a/content/en/docs/v1.3/virtualization/vm-instance.md +++ b/content/en/docs/v1.3/virtualization/vm-instance.md @@ -10,7 +10,7 @@ aliases: @@ -50,31 +50,32 @@ virtctl ssh @ ### Common parameters -| Name | Description | Type | Value | -| ------------------- | --------------------------------------------------------------------------------------------------------------------------------- | ---------- | ----------- | -| `external` | Enable external access from outside the cluster. | `bool` | `false` | -| `externalMethod` | Method to pass through traffic to the VM. | `string` | `PortList` | -| `externalPorts` | Ports to forward from outside the cluster. | `[]int` | `[22]` | -| `runStrategy` | Requested running state of the VirtualMachineInstance | `string` | `Always` | -| `instanceType` | Virtual Machine instance type. | `string` | `u1.medium` | -| `instanceProfile` | Virtual Machine preferences profile. | `string` | `ubuntu` | -| `disks` | List of disks to attach. | `[]object` | `[]` | -| `disks[i].name` | Disk name. | `string` | `""` | -| `disks[i].bus` | Disk bus type (e.g. "sata"). | `string` | `""` | -| `networks` | Networks to attach the VM to. | `[]object` | `[]` | -| `networks[i].name` | Network attachment name. | `string` | `""` | -| `subnets` | Deprecated: use networks instead. | `[]object` | `[]` | -| `subnets[i].name` | Network attachment name. | `string` | `""` | -| `gpus` | List of GPUs to attach (NVIDIA driver requires at least 4 GiB RAM). | `[]object` | `[]` | -| `gpus[i].name` | The name of the GPU resource to attach. | `string` | `""` | -| `cpuModel` | Model specifies the CPU model inside the VMI. List of available models https://github.com/libvirt/libvirt/tree/master/src/cpu_map | `string` | `""` | -| `resources` | Resource configuration for the virtual machine. | `object` | `{}` | -| `resources.cpu` | Number of CPU cores allocated. | `quantity` | `""` | -| `resources.memory` | Amount of memory allocated. | `quantity` | `""` | -| `resources.sockets` | Number of CPU sockets (vCPU topology). | `quantity` | `""` | -| `sshKeys` | List of SSH public keys for authentication. | `[]string` | `[]` | -| `cloudInit` | Cloud-init user data. | `string` | `""` | -| `cloudInitSeed` | Seed string to generate SMBIOS UUID for the VM. | `string` | `""` | +| Name | Description | Type | Value | +| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | ----------- | +| `external` | Enable external access from outside the cluster. | `bool` | `false` | +| `externalMethod` | Method to pass through traffic to the VM. | `string` | `PortList` | +| `externalPorts` | Ports to forward from outside the cluster. | `[]int` | `[22]` | +| `externalAllowICMP` | Whether to accept ICMP traffic to the VM in PortList mode (preserves ping and PMTU discovery). No effect in WholeIP mode. Default true so ping behaves as users expect even when port filtering is in effect. | `bool` | `true` | +| `runStrategy` | Requested running state of the VirtualMachineInstance | `string` | `Always` | +| `instanceType` | Virtual Machine instance type. | `string` | `u1.medium` | +| `instanceProfile` | Virtual Machine preferences profile. | `string` | `ubuntu` | +| `disks` | List of disks to attach. | `[]object` | `[]` | +| `disks[i].name` | Disk name. | `string` | `""` | +| `disks[i].bus` | Disk bus type (e.g. "sata"). | `string` | `""` | +| `networks` | Networks to attach the VM to. | `[]object` | `[]` | +| `networks[i].name` | Network attachment name. | `string` | `""` | +| `subnets` | Deprecated: use networks instead. | `[]object` | `[]` | +| `subnets[i].name` | Network attachment name. | `string` | `""` | +| `gpus` | List of GPUs to attach (NVIDIA driver requires at least 4 GiB RAM). | `[]object` | `[]` | +| `gpus[i].name` | The name of the GPU resource to attach. | `string` | `""` | +| `cpuModel` | Model specifies the CPU model inside the VMI. List of available models https://github.com/libvirt/libvirt/tree/master/src/cpu_map | `string` | `""` | +| `resources` | Resource configuration for the virtual machine. | `object` | `{}` | +| `resources.cpu` | Number of CPU cores allocated. | `quantity` | `""` | +| `resources.memory` | Amount of memory allocated. | `quantity` | `""` | +| `resources.sockets` | Number of CPU sockets (vCPU topology). | `quantity` | `""` | +| `sshKeys` | List of SSH public keys for authentication. | `[]string` | `[]` | +| `cloudInit` | Cloud-init user data. | `string` | `""` | +| `cloudInitSeed` | Seed string to generate SMBIOS UUID for the VM. | `string` | `""` | ## U Series