docs(plugins): Spinnaker Plugins section (#1884)

* docs(plugins): DOC-718 Spinnaker Plugins section

* add link to armory.io PE page

* policy engine - move release notes to separate age

* create includes/plugin directory

* add directions to create client creds for Spinnaker to CDaaS plugin

* update plugins landing page

* fix plugin-guide section redirect

* update page descriptions

* word tweak on landing page

* remove "Armory" from plugin names in compat matrix on landing page

* update landing page blurb

* modify readfile shortcode to throw error

add plugin compat matrix include

Author: aimeeu

config-generated.toml

@@ -97,9 +97,9 @@ weight = 3
 url = "/continuous-deployment/"
 
 [[menu.main]]
-name = "Scale Agent"
+name = "Spinnaker Plugins"
 weight = 4
-url = "/scale-agent/"
+url = "/plugins/"
 
 [[menu.main]]
 name = "Support"

config-modules.yaml

@@ -74,9 +74,9 @@ menu:
     - name: Armory CD
       weight: 3
       url: /continuous-deployment/
-    - name: Scale Agent
+    - name: Spinnaker Plugins
       weight: 4
-      url: /scale-agent/
+      url: /plugins/
     - name: Support
       weight: 5
       url: "https://support.armory.io/"

config.toml

@@ -126,9 +126,9 @@ weight = 1
   url = "/continuous-deployment/"
 
 [[menu.main]]
-  name = "Scale Agent"
+  name = "Spinnaker Plugins"
   weight = 4
-  url = "/scale-agent/"
+  url = "/plugins/"
 
 [[menu.main]]
   name = "Support"

content/en/_index.html

@@ -53,7 +53,7 @@ <h3 class="text-center mt-3">
 				<a class="btn btn-secondary white" href="{{< relref "/continuous-deployment/" >}}">
 					View Documentation
 				</a>
-				<a class="small-link mt-3" href="https://www.armory.io/armory-enterprise-spinnaker/" target="_blank">
+				<a class="small-link mt-3" href="https://www.armory.io/products/continuous-deployment-self-hosted/" target="_blank">
 					<span>Learn More</span>
 					<i>&LongRightArrow;</i>
 				</a>
@@ -71,10 +71,10 @@ <h3 class="text-center mt-3">
 				Kubernetes deployments at massive scale, without the massive headache
 			</p>
 			<div class="link-container">
-				<a class="btn btn-secondary white" href="{{< relref "/scale-agent/" >}}">
+				<a class="btn btn-secondary white" href="{{< relref "/plugins/scale-agent/" >}}">
 					View Documentation
 				</a>
-				<a class="small-link mt-3" href="https://www.armory.io/armory-enterprise-spinnaker/armory-agent-for-kubernetes/" target="_blank">
+				<a class="small-link mt-3" href="https://www.armory.io/products/scale-agent-for-spinnaker-kubernetes/" target="_blank">
 					<span>Learn More</span>
 					<i>&LongRightArrow;</i>
 				</a>

content/en/cd-as-a-service/plugin-spinnaker.md

@@ -11,7 +11,7 @@ Armory CD-as-a-Service uses agents that run in target Kubernetes clusters to com
 
 There are no additional requirements for installing the agents that Armory CD-as-a-Service uses. For information about how to install these agents, see [Enable the Armory CD-as-a-Service Remote Network Agent in target Kubernetes clusters]({{< ref "plugin-spinnaker#enable-the-armory-cd-as-a-service-remote-network-agent-in-target-kubernetes-clusters" >}}) or {{< linkWithTitle "get-started" >}}.
 
-> If you are using the Armory Scale Agent for Spinnaker and Kubernetes, that is a separate agent from the Remote Networking Agent. It has its own requirements. For more information, see {{< linkWithTitle "scale-agent/install/_index.md" >}}.
+> If you are using the Armory Scale Agent for Spinnaker and Kubernetes, that is a separate agent from the Remote Networking Agent. It has its own requirements. For more information, see {{< linkWithTitle "plugins/scale-agent/_index.md" >}}.
 
 ## Deployment target
 

content/en/cd-as-a-service/release-notes/requirements.md

@@ -62,7 +62,7 @@ Rosco is the "bakery" service. It is a wrapper around Hashicorp's Packer command
 
 ### Armory Scale Agent for Spinnaker and Kubernetes
 
-The {{< linkWithTitle "scale-agent/_index.md" >}} is a lightweight, scalable service that monitors your Kubernetes infrastructure and streams changes back to the Clouddriver service.
+The {{< linkWithTitle "plugins/scale-agent/_index.md" >}} is a lightweight, scalable service that monitors your Kubernetes infrastructure and streams changes back to the Clouddriver service.
 
 ### Dinghy
 
@@ -73,7 +73,7 @@ The {{< linkWithTitle "scale-agent/_index.md" >}} is a lightweight, scalable ser
 
 ### Policy Engine
 
-The [Armory Policy Engine]({{< ref "policy-engine" >}}) is designed to allow enterprises more complete control of their software delivery process by providing them with the hooks necessary to perform more extensive verification of their pipelines and processes in Spinnaker. This policy engine is backed by Open Policy Agent(OPA) and uses input style documents to perform validation of pipelines during save time and runtime
+The [Armory Policy Engine]({{< ref "plugins/policy-engine" >}}) is designed to allow enterprises more complete control of their software delivery process by providing them with the hooks necessary to perform more extensive verification of their pipelines and processes in Spinnaker. This policy engine is backed by Open Policy Agent(OPA) and uses input style documents to perform validation of pipelines during save time and runtime
 
 ### Terraformer
 

content/en/continuous-deployment/Overview/architecture.md

@@ -3,7 +3,7 @@ title: Armory Continuous Deployment
 weight: 10
 no_list: true
 description: >
-  Guides and release notes for Armory Continuous Deployment products including Armory Continuous Deployment Self-Hosted, Armory Operator, and Armory Scale Agent for Spinnaker and Kubernetes.
+  Guides and release notes for Armory Continuous Deployment Self-Hosted and the Armory Operators.
 ---
 
 ## What is Armory Continuous Deployment?
@@ -24,6 +24,8 @@ The [Armory Operator]({{< ref "armory-operator" >}}) is a Kubernetes Operator th
 
 The open source [Spinnaker Operator](https://github.com/armory/spinnaker-operator) provides features to deploy and manage open source Spinnaker.
 
-### Armory Scale Agent for Spinnaker and Kubernetes
+### Plugins for Spinnaker and Armory CD
+
+{{% readfile "/includes/plugins/plugin-compat-matrix.md" %}}
+
 
-The {{< linkWithTitle "scale-agent/_index.md" >}} is a lightweight, scalable service that monitors your Kubernetes infrastructure and streams changes back to Spinnaker's Clouddriver service.

content/en/continuous-deployment/_index.md

@@ -59,4 +59,4 @@ When using a cache store like Redis that works across multiple Clouddriver insta
 ## Next steps
 
 * {{< linkWithTitle "caching-agents-config.md" >}}
-* If you are using Kubernetes and would like to use a different method for cataloging your Kubernetes infrastructure, see {{< linkWithTitle "scale-agent/_index.md" >}}.
+* If you are using Kubernetes and would like to use a different method for cataloging your Kubernetes infrastructure, see {{< linkWithTitle "plugins/scale-agent/_index.md" >}}.

content/en/continuous-deployment/armory-admin/caching-agents-concept.md

@@ -422,40 +422,6 @@ The following table lists the supported pipeline triggers:
 | Webhook        | All supported versions    |                                 |
 
 
-
-## Policy Engine
-
-[![Generally available](/images/ga.svg)]({{< ref "release-definitions#ga" >}}) ![Proprietary](/images/proprietary.svg)
-
-The [Policy Engine]({{< ref "policy-engine" >}}) gives you the ability to ensure any pipeline meets certain requirements that you specify.
-
-{{< include "policy-engine/plugin-compat-matrix.md" >}}
-
-**OPA requirements**
-
-The Policy Engine requires an Open Policy Agent server. This can be deployed in the same cluster as Armory Continuous Deployment or in an external cluster.
-
-The following table lists the requirements:
-
-| Requirement | Version         | Note                                                                                                                                                                             |
-| ----------- | --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| OPA Server  | 0.12.x or later | Specifically, the v1 API must be available. When you specify the OPA server URL in the Armory Continuous Deployment configs, include `v1` in the URL: `http://<your-opa-server>:<port>/v1`. |
-
-**Supported validations**
-
-| Validation           | Armory Continuous Deployment Version | Note                                                                                                             |
-| -------------------- | ------------------------- | ---------------------------------------------------------------------------------------------------------------- |
-| Save time validation | All supported versions    | If no policies are set, you cannot save any pipelines until you set any policy or turn off save time validation. |
-| Runtime validation   | All supported versions    | If no policies are set, no policy enforcement occurs and pipelines run as they do normally.                      |
-
-## Scale Agent
-
-[![Generally available](/images/ga.svg)]({{< ref "release-definitions#ga" >}})![Proprietary](/images/proprietary.svg)
-
-{{< include "scale-agent/agent-compat-matrix.md" >}}
-
-For a full list of previous releases, see this [page](https://armory.jfrog.io/artifactory/manifests/).
-
 ## Secret stores
 
 [![Generally available](/images/ga.svg)]({{< ref "release-definitions#ga" >}}) ![OSS](/images/oss.svg) ![Proprietary](/images/proprietary.svg)

content/en/continuous-deployment/feature-status/continuous-deployment-matrix/_index.md

@@ -74,7 +74,7 @@ Renders as:
 
 See the {{< linkWithTitle best-practices.md >}} page...
 
-See this page: {{< linkWithTitle "scale-agent/tasks/service-monitor.md" >}}.
+See this page: {{< linkWithTitle "plugins/scale-agent/tasks/service-monitor.md" >}}.
 
 ### Google suite shortcode
 

content/en/continuous-deployment/plugin-guide/_index.md

@@ -4,7 +4,7 @@ The following table lists the plugins and their required minimum version:
 
 |  Plugin |  Version  |
 |---------|-----------|
-| [Armory Agent for Kubernetes Clouddriver Plugin]({{< ref "scale-agent/release-notes/agent-plugin" >}}) | 0.10.0 | 
+| [Armory Agent for Kubernetes Clouddriver Plugin]({{< ref "plugins/scale-agent/release-notes/agent-plugin" >}}) | 0.10.0 | 
 | App Name | 0.2.0 |
 | [AWS Lambda](https://github.com/spinnaker-plugins/aws-lambda-deployment-plugin-spinnaker/releases) | 1.0.9   |
 | [Evaluate Artifacts](https://github.com/armory-plugins/evaluate-artifacts-releases/releases) | 0.1.1 |

content/en/continuous-deployment/plugin-guide/cdaas-spinnaker.md

@@ -6,7 +6,7 @@ The following table lists the plugins and their required minimum version:
 
 | Plugin                                                                                             | Version |
 | -------------------------------------------------------------------------------------------------- | ------- |
-| [Scale Agent for Spinnaker and Kubernetes Clouddriver Plugin]({{< ref "scale-agent/_index.md" >}})                     | 0.11.0  |
+| [Scale Agent for Spinnaker and Kubernetes Clouddriver Plugin]({{< ref "plugins/scale-agent/_index.md" >}})                     | 0.11.0  |
 | App Name                                                                                           | 0.2.0   |
 | [AWS Lambda](https://github.com/spinnaker-plugins/aws-lambda-deployment-plugin-spinnaker/releases) | 1.0.10  |
 | [Evaluate Artifacts](https://github.com/armory-plugins/evaluate-artifacts-releases/releases)       | 0.1.1   |

content/en/contribute/create/guides/shortcodes/_index.md

@@ -1,13 +1,13 @@
-All network traffic is encrypted while in transit.
-
-Encryption in transit is over HTTPS using TLS encryption. When using Armory-provided software for both the client and server, these connections are secured by TLS 1.2. Certain APIs support older TLS versions for clients that do not support 1.2.
-
-Encryption at rest uses AES256 encryption.
-
 The following network endpoints are used for communication into Armory CD-as-a-Service:
 
 | DNS                       | Port | Protocol                                        | Description                                                                                                                                                                                                                                                                                                                                                     |
 | ------------------------- | ---- | ----------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | agent-hub.cloud.armory.io | 443  | TLS enabled gRPC over HTTP/2<br>TLS version 1.2 | Remote Network Agent Hub connection; Agent Hub routes deployment commands to RNAs and caches data received from them. Agent Hub does not require direct network access to the RNAs since they connect to Agent Hub through an encrypted, long-lived gRPC HTTP2 connection. Agent Hub uses this connection to send deployment commands to the RNA for execution. |
 | api.cloud.armory.io       | 443  | HTTP over TLS (HTTPS)<br>TLS version 1.2        | Armory REST API; Clients connect to these APIs to interact with Armory CD-as-a-Service.                                                                                                                                                                                                                                                                         |
-| auth.cloud.armory.io      | 443  | HTTP over TLS (HTTPS)<br>TLS version 1.2        | OIDC Service; The Open ID Connect (OIDC) service is used to authorize and authenticate machines and users. The RNAs, Armory Continuous Deployment (Spinnaker) plugin, and other services all authenticate against this endpoint. The service provides an identity token that can be passed to the Armory API and Agent Hub.                                                |
+| auth.cloud.armory.io      | 443  | HTTP over TLS (HTTPS)<br>TLS version 1.2        | OIDC Service; The Open ID Connect (OIDC) service is used to authorize and authenticate machines and users. The RNAs, Armory Continuous Deployment (Spinnaker) plugin, and other services all authenticate against this endpoint. The service provides an identity token that can be passed to the Armory API and Agent Hub.                                                |
+
+All network traffic is encrypted while in transit.
+
+Encryption in transit is over HTTPS using TLS encryption. When using Armory-provided software for both the client and server, these connections are secured by TLS 1.2. Certain APIs support older TLS versions for clients that do not support 1.2.
+
+Encryption at rest uses AES256 encryption.

content/en/includes/breaking-changes/bc-plug-version-lts-227.md

@@ -0,0 +1,6 @@
+| Plugin | Spinnaker | Armory CD |
+|:-------|:--------:|:--------:|
+| {{< linkWithLinkTitle "plugins/cdaas-spinnaker.md" >}}<br>{{% getPageDesc "/plugins/cdaas-spinnaker.md" %}} | 1.24+ | 2.24+<br>(included with Armory CD)|
+| {{< linkWithLinkTitle "plugins/plugin-k8s-custom-resource-status.md" >}}<br>{{% getPageDesc "/plugins/plugin-k8s-custom-resource-status.md" %}}  | 1.27+ | 2.27+ |
+| {{< linkWithLinkTitle "plugins/policy-engine/_index.md" >}}<br>{{% getPageDesc "/plugins/policy-engine/_index.md" %}}  | 1.26+ | 2.26+ |
+| {{< linkWithLinkTitle "plugins/scale-agent/_index.md" >}}<br>{{% getPageDesc "/plugins/scale-agent/_index.md" %}}  | 1.26+ | 2.26+ |

content/en/includes/breaking-changes/bc-plugin-compatibility-2-28-0.md

@@ -1,6 +1 @@
-Armory helps software teams ship better software, faster. Armory Continuous Deployment (Armory CD) is an enterprise-grade distribution of Spinnaker™ that runs in your Kubernetes cluster. Armory CD is an extension of open source Spinnaker and includes all of those benefits as well as the following:
-
-- [Pipelines as Code (Dinghy)]({{< ref "using-dinghy" >}}) allows you to store Spinnaker pipelines in Github and manage them like you would manage code, including version control, templatization, and modularization. Spinnaker pipelines are flexible and customizable series of deployment stages. Combine all these to rapidly and repeatably scale pipelines in your Spinnaker deployment.
-- [Policy Engine]({{< ref "policy-engine" >}}) helps you meet compliance requirements based on custom policies you set. You can configure the Policy Engine to verify that your pipelines meet certain requirements at save time or at runtime. You can use the Policy Engine with Armory Continuous Deployment (Armory CD) and open source Spinnaker.
-- [Terraform integration]({{< ref "terraform-use-integration" >}}) allows you to use your existing Terraform scripts to plan and create infrastructure as part a Spinnaker pipeline. You can deploy your application and infrastructure all in a single pipeline.
-- Integrations with many of your existing tools. For a full list, see [Integrations](https://www.armory.io/armory-spinnaker/integrations/).
+Armory helps software teams ship better software, faster. Armory Continuous Deployment (Armory CD) is an enterprise-grade distribution of Spinnaker™ that runs in your Kubernetes cluster. Armory CD extends Spinnaker with both essential and optional premium plugins. See the [Armory Continuous Deployment Self-Hosted product page](https://www.armory.io/products/continuous-deployment-self-hosted/) for complete list of featues and pricing.