From 5add8559cda870b9860b56b4c9acc7ca254dcb14 Mon Sep 17 00:00:00 2001 From: Hannah Cooper Date: Fri, 30 Jan 2026 00:59:14 +0000 Subject: [PATCH] GITBOOK-35: Policy page improvements --- SUMMARY.md | 20 +++++++++---------- .../policies/README.md | 14 +++++++++---- .../{docker => docker-policies}/README.md | 0 .../rbac-policy.md | 0 .../registry-policy.md | 0 .../security-policy.md | 0 .../setup-policy.md | 0 .../README.md | 0 .../kubernetes-rbac-policy.md | 0 .../kubernetes-registry-policy.md | 0 .../kubernetes-security-policy.md | 0 .../kubernetes-setup-policy.md | 0 whats-new.md | 2 +- 13 files changed, 21 insertions(+), 15 deletions(-) rename user/policy-based-management/policies/{docker => docker-policies}/README.md (100%) rename user/policy-based-management/policies/{docker => docker-policies}/rbac-policy.md (100%) rename user/policy-based-management/policies/{docker => docker-policies}/registry-policy.md (100%) rename user/policy-based-management/policies/{docker => docker-policies}/security-policy.md (100%) rename user/policy-based-management/policies/{docker => docker-policies}/setup-policy.md (100%) rename user/policy-based-management/policies/{kubernetes => kubernetes-policies}/README.md (100%) rename user/policy-based-management/policies/{kubernetes => kubernetes-policies}/kubernetes-rbac-policy.md (100%) rename user/policy-based-management/policies/{kubernetes => kubernetes-policies}/kubernetes-registry-policy.md (100%) rename user/policy-based-management/policies/{kubernetes => kubernetes-policies}/kubernetes-security-policy.md (100%) rename user/policy-based-management/policies/{kubernetes => kubernetes-policies}/kubernetes-setup-policy.md (100%) diff --git a/SUMMARY.md b/SUMMARY.md index 73980e9a..78bebdf3 100644 --- a/SUMMARY.md +++ b/SUMMARY.md @@ -197,16 +197,16 @@ * [Alerting](user/observability/alerting.md) * [Policy Based Management](user/policy-based-management/README.md) * [Policies](user/policy-based-management/policies/README.md) - * [Kubernetes](user/policy-based-management/policies/kubernetes/README.md) - * [Create a Kubernetes RBAC policy](user/policy-based-management/policies/kubernetes/kubernetes-rbac-policy.md) - * [Create a Kubernetes security policy](user/policy-based-management/policies/kubernetes/kubernetes-security-policy.md) - * [Create a Kubernetes setup policy](user/policy-based-management/policies/kubernetes/kubernetes-setup-policy.md) - * [Create a Kubernetes registry policy](user/policy-based-management/policies/kubernetes/kubernetes-registry-policy.md) - * [Docker](user/policy-based-management/policies/docker/README.md) - * [Create a Docker, Swarm or Podman RBAC policy](user/policy-based-management/policies/docker/rbac-policy.md) - * [Create a Docker, Swarm or Podman security policy](user/policy-based-management/policies/docker/security-policy.md) - * [Create a Docker, Swarm or Podman setup policy](user/policy-based-management/policies/docker/setup-policy.md) - * [Create a Docker, Swarm or Podman registry policy](user/policy-based-management/policies/docker/registry-policy.md) + * [Kubernetes Policies](user/policy-based-management/policies/kubernetes-policies/README.md) + * [Create a Kubernetes RBAC policy](user/policy-based-management/policies/kubernetes-policies/kubernetes-rbac-policy.md) + * [Create a Kubernetes security policy](user/policy-based-management/policies/kubernetes-policies/kubernetes-security-policy.md) + * [Create a Kubernetes setup policy](user/policy-based-management/policies/kubernetes-policies/kubernetes-setup-policy.md) + * [Create a Kubernetes registry policy](user/policy-based-management/policies/kubernetes-policies/kubernetes-registry-policy.md) + * [Docker Policies](user/policy-based-management/policies/docker-policies/README.md) + * [Create a Docker, Swarm or Podman RBAC policy](user/policy-based-management/policies/docker-policies/rbac-policy.md) + * [Create a Docker, Swarm or Podman security policy](user/policy-based-management/policies/docker-policies/security-policy.md) + * [Create a Docker, Swarm or Podman setup policy](user/policy-based-management/policies/docker-policies/setup-policy.md) + * [Create a Docker, Swarm or Podman registry policy](user/policy-based-management/policies/docker-policies/registry-policy.md) * [Account settings](user/account-settings.md) ## Administering Portainer diff --git a/user/policy-based-management/policies/README.md b/user/policy-based-management/policies/README.md index b6b374c0..d50911b0 100644 --- a/user/policy-based-management/policies/README.md +++ b/user/policy-based-management/policies/README.md @@ -30,11 +30,17 @@ From the menu, under **Additional Functionality**, select **Policy Based Managem
-There multiple policy types available, depending on the environment type you are managing and the kind of access you want to enforce. You can use the search function or filter by environment type or policy category to narrow down the list. +There are multiple policy types available, depending on the environment type you are managing and the kind of access you want to enforce. You can use the search function or filter by environment type or policy category to narrow down the list. -After selecting a policy type, select **Continue** at the bottom of the page to open the configuration form. The fields shown will vary depending on the policy you are creating, and each form guides you through the required settings for that specific policy. Select a policy type below for more details on creating the policy. +After selecting a policy type, select **Continue** at the bottom of the page to open the configuration form. The fields shown will vary depending on the policy you are creating, and each form guides you through the required settings for that specific policy. Select an environment type below for more details on creating the policy. -
Cover image

Kubernetes RBAC

kubernetes-rbac-policy.md2.37.0-Kube-rbac-1.png

Kubernetes Security

kubernetes-security-policy.md2.37.0-Kube-security.png

Kubernetes Setup

kubernetes-setup-policy.md2.37.0-Kube-setup-policy.png

Kubernetes Registry

kubernetes-registry-policy.md2.37.0-Kube-Reg-policy.png

Docker / Swarm / Podman RBAC

rbac-policy.md2.37.0-RBAC-policy.png

Docker / Swarm / Podman Security

security-policy.md2.37.0-Security-policy.png

Docker / Swarm / Podman Setup

setup-policy.md2.37.0-Setup-policy.png

Docker / Swarm / Podman Registry

registry-policy.mdScreenshot 2025-12-05 at 10.23.28 AM.png
+{% content-ref url="kubernetes-policies/" %} +[kubernetes-policies](kubernetes-policies/) +{% endcontent-ref %} + +{% content-ref url="docker-policies/" %} +[docker-policies](docker-policies/) +{% endcontent-ref %} ## View policy details @@ -72,7 +78,7 @@ The attachment tab displays details about the environments attached to the polic ### Settings -The Settings tab shows the policy configuration. Settings vary by policy type. Details for each policy type are covered in the [Kubernetes policies](kubernetes/) and [Docker policies](docker/) sections of this documentation. +The Settings tab shows the policy configuration. Settings vary by policy type. Details for each policy type are covered in the [Kubernetes policies](kubernetes-policies/) and [Docker policies](docker-policies/) sections of this documentation. ## Remove a policy diff --git a/user/policy-based-management/policies/docker/README.md b/user/policy-based-management/policies/docker-policies/README.md similarity index 100% rename from user/policy-based-management/policies/docker/README.md rename to user/policy-based-management/policies/docker-policies/README.md diff --git a/user/policy-based-management/policies/docker/rbac-policy.md b/user/policy-based-management/policies/docker-policies/rbac-policy.md similarity index 100% rename from user/policy-based-management/policies/docker/rbac-policy.md rename to user/policy-based-management/policies/docker-policies/rbac-policy.md diff --git a/user/policy-based-management/policies/docker/registry-policy.md b/user/policy-based-management/policies/docker-policies/registry-policy.md similarity index 100% rename from user/policy-based-management/policies/docker/registry-policy.md rename to user/policy-based-management/policies/docker-policies/registry-policy.md diff --git a/user/policy-based-management/policies/docker/security-policy.md b/user/policy-based-management/policies/docker-policies/security-policy.md similarity index 100% rename from user/policy-based-management/policies/docker/security-policy.md rename to user/policy-based-management/policies/docker-policies/security-policy.md diff --git a/user/policy-based-management/policies/docker/setup-policy.md b/user/policy-based-management/policies/docker-policies/setup-policy.md similarity index 100% rename from user/policy-based-management/policies/docker/setup-policy.md rename to user/policy-based-management/policies/docker-policies/setup-policy.md diff --git a/user/policy-based-management/policies/kubernetes/README.md b/user/policy-based-management/policies/kubernetes-policies/README.md similarity index 100% rename from user/policy-based-management/policies/kubernetes/README.md rename to user/policy-based-management/policies/kubernetes-policies/README.md diff --git a/user/policy-based-management/policies/kubernetes/kubernetes-rbac-policy.md b/user/policy-based-management/policies/kubernetes-policies/kubernetes-rbac-policy.md similarity index 100% rename from user/policy-based-management/policies/kubernetes/kubernetes-rbac-policy.md rename to user/policy-based-management/policies/kubernetes-policies/kubernetes-rbac-policy.md diff --git a/user/policy-based-management/policies/kubernetes/kubernetes-registry-policy.md b/user/policy-based-management/policies/kubernetes-policies/kubernetes-registry-policy.md similarity index 100% rename from user/policy-based-management/policies/kubernetes/kubernetes-registry-policy.md rename to user/policy-based-management/policies/kubernetes-policies/kubernetes-registry-policy.md diff --git a/user/policy-based-management/policies/kubernetes/kubernetes-security-policy.md b/user/policy-based-management/policies/kubernetes-policies/kubernetes-security-policy.md similarity index 100% rename from user/policy-based-management/policies/kubernetes/kubernetes-security-policy.md rename to user/policy-based-management/policies/kubernetes-policies/kubernetes-security-policy.md diff --git a/user/policy-based-management/policies/kubernetes/kubernetes-setup-policy.md b/user/policy-based-management/policies/kubernetes-policies/kubernetes-setup-policy.md similarity index 100% rename from user/policy-based-management/policies/kubernetes/kubernetes-setup-policy.md rename to user/policy-based-management/policies/kubernetes-policies/kubernetes-setup-policy.md diff --git a/whats-new.md b/whats-new.md index 7a66166c..413c9b32 100644 --- a/whats-new.md +++ b/whats-new.md @@ -20,6 +20,6 @@ You can read more about our release principles in our [lifecycle policy](start/l Since the initial release of [Policies](user/policy-based-management/policies/) as part of the Policy Based Management feature, improvements and new functionality have been added to simplify creating centralized policies across groups of environments. -Along with [numerous fixes and UI improvements](release-notes.md#release-2.38.0-sts), this release introduces policy templates that provide preconfigured policies, making policy creation possible in just a few clicks. Templates are currently available for [Kubernetes security ](user/policy-based-management/policies/kubernetes/kubernetes-security-policy.md)and [Docker security](user/policy-based-management/policies/docker/security-policy.md) policies, with more to come in future releases. +Along with [numerous fixes and UI improvements](release-notes.md#release-2.38.0-sts), this release introduces policy templates that provide preconfigured policies, making policy creation possible in just a few clicks. Templates are currently available for [Kubernetes security ](user/policy-based-management/policies/kubernetes-policies/kubernetes-security-policy.md)and [Docker security](user/policy-based-management/policies/docker-policies/security-policy.md) policies, with more to come in future releases.