From 3647ba6da46fb143df9542110715a00a0341ca02 Mon Sep 17 00:00:00 2001 From: rahulshendre Date: Tue, 27 Jan 2026 00:53:08 +0530 Subject: [PATCH 1/2] fix grammer and inconsistencies Signed-off-by: rahulshendre --- .../contributing-plugins.md | 8 +-- docs/content/en/docs-v1.0.x/faq/_index.md | 30 +++++------ .../en/docs-v1.0.x/installation/_index.md | 10 ++-- .../install-control-plane/_index.md | 2 +- .../installing-controlplane-on-ECS.md | 2 +- .../installing-controlplane-on-k8s.md | 48 +++++++++--------- .../installation/install-piped/_index.md | 8 +-- .../install-piped/installing-on-kubernetes.md | 48 +++++++++--------- .../installing-on-single-machine.md | 32 ++++++------ .../migrating-from-v0-to-v1/_index.md | 8 +-- .../content/en/docs-v1.0.x/overview/_index.md | 28 +++++------ .../en/docs-v1.0.x/quickstart/_index.md | 50 +++++++++---------- .../user-guide/command-line-tool.md | 8 +-- .../user-guide/managing-application/_index.md | 2 +- .../adding-an-application.md | 20 ++++---- .../managing-application/deployment-trace.md | 4 +- .../managing-application/event-watcher.md | 14 +++--- .../manifest-attachment.md | 8 +-- .../managing-application/plan-preview.md | 2 +- .../managing-application/secret-management.md | 6 +-- .../triggering-a-deployment.md | 2 +- .../managing-controlplane/adding-a-project.md | 4 +- .../architecture-overview.md | 4 +- .../user-guide/managing-controlplane/auth.md | 10 ++-- .../registering-a-piped.md | 2 +- .../observability-and-metrics/_index.md | 2 +- .../observability-and-metrics/metrics.md | 14 +++--- .../user-guide/terraform-provider-pipecd.md | 6 +-- 28 files changed, 191 insertions(+), 191 deletions(-) diff --git a/docs/content/en/docs-v1.0.x/contribution-guidelines/contributing-plugins.md b/docs/content/en/docs-v1.0.x/contribution-guidelines/contributing-plugins.md index 65dbaa2e7b..3fb0f5b9fc 100644 --- a/docs/content/en/docs-v1.0.x/contribution-guidelines/contributing-plugins.md +++ b/docs/content/en/docs-v1.0.x/contribution-guidelines/contributing-plugins.md @@ -6,15 +6,15 @@ description: > Learn how to create PipeCD plugins. --- -PipeCD's plugin architecture allows anyone to extend piped's capabilities by creating custom plugins. This guide explains how to develop and contribute plugins. +PipeCD's plugin architecture allows anyone to extend `piped`'s capabilities by creating custom plugins. This guide explains how to develop and contribute plugins. ## Understanding the plugin architecture -In PipeCD v1, plugins are the actors that execute deployments on behalf of piped. Instead of piped directly deploying to platforms, plugins handle platform-specific logic while piped's core controls deployment flows. +In PipeCD v1, plugins are the actors that execute deployments on behalf of `piped`. Instead of `piped` directly deploying to platforms, plugins handle platform-specific logic while `piped`'s core controls deployment flows. **Key concepts:** -- **Plugins** run as gRPC servers, launched and managed by piped +- **Plugins** run as gRPC servers, launched and managed by `piped` - **Deploy targets** define where a plugin deploys (e.g., a Kubernetes cluster) - Plugins can be **official** (maintained by PipeCD team) or **community-contributed** @@ -81,7 +81,7 @@ your-plugin/ ### Plugin configuration -Plugins are configured in the piped config. See the [piped installation guide](/docs-v1.0.x/installation/install-piped/) for configuration examples: +Plugins are configured in the `piped` config. See the [`piped` installation guide](/docs-v1.0.x/installation/install-piped/) for configuration examples: ```yaml apiVersion: pipecd.dev/v1beta1 diff --git a/docs/content/en/docs-v1.0.x/faq/_index.md b/docs/content/en/docs-v1.0.x/faq/_index.md index 3197c7fad3..7bceeda53b 100644 --- a/docs/content/en/docs-v1.0.x/faq/_index.md +++ b/docs/content/en/docs-v1.0.x/faq/_index.md @@ -8,13 +8,13 @@ description: > We have answered some of the most frequently asked questions below. If you have any other questions, please feel free to create the issue in the [pipe-cd/pipecd](https://github.com/pipe-cd/pipecd/issues/new/choose) repository or contact us on [Cloud Native Slack](https://slack.cncf.io) (channel [#pipecd](https://app.slack.com/client/T08PSQ7BQ/C01B27F9T0X)). -### 1. What is PipeCD V1? How is it different from the PipeCD Versions so far? +### 1. What is PipeCD v1? How is it different from the PipeCD versions so far? -PipeCD V1 introduces a plugin-based architecture where each application deployment is managed by a 'plugin', created specifically for that application. This replaces the concept of Platform Providers from earlier versions of PipeCD. This change makes PipeCD versatile, allowing users to create custom plugins to deploy the application of their choice. +PipeCD v1 introduces a plugin-based architecture where each application deployment is managed by a 'plugin', created specifically for that application. This replaces the concept of Platform Providers from earlier versions of PipeCD. This change makes PipeCD versatile, allowing users to create custom plugins to deploy the application of their choice. -### 2. What kind of applications will be supported in PipeCD V1? +### 2. What kind of applications will be supported in PipeCD v1? -Since PipeCD V1 introduces a plugin architecture, you can now deploy any application using plugins. +Since PipeCD v1 introduces a plugin architecture, you can now deploy any application using plugins. Check out the latest releases on GitHub for the list of available plugins. Additionally, we also have a Community Plugins Repository for plugins made by the PipeCD community. As of now, the official plugins maintained by the PipeCD Maintainers are Kubernetes, Terraform, Analysis, ScriptRun, Wait, and WaitApproval. @@ -30,38 +30,38 @@ Yes, you can use PipeCD for both mesh (Istio, SMI) applications and non-mesh app ### 5. What are the differences between PipeCD and FluxCD? -- Apart from Kubernetes applications, PipeCD also provides a unified interface for other cloud services (GCP Cloud Run, AWS ECS, AWS Lambda and more). Starting PipeCD V1, users can use PipeCD with even more applications by creating custom plugins for their deployments. +- Apart from Kubernetes applications, PipeCD also provides a unified interface for other cloud services (GCP Cloud Run, AWS ECS, AWS Lambda and more). Starting PipeCD v1, users can use PipeCD with even more applications by creating custom plugins for their deployments. Here are some standout features of PipeCD when compared to Flux: - One tool for both GitOps sync and progressive deployment - Supports multiple Git repositories - Has web UI for better visibility - Log viewer for each deployment - - Visualization of application component/state in realtime - - Show configuration drift in realtime + - Visualization of application component/state in real-time + - Show configuration drift in real-time - Also supports Canary and BlueGreen for non-mesh applications - Has built-in secrets management - Shows the delivery performance insights ### 6. What are the differences between PipeCD and ArgoCD? -- Apart from Kubernetes applications, PipeCD also provides a unified interface for other cloud services (GCP Cloud Run, AWS ECS, AWS Lambda and more). Starting PipeCD V1, users can use PipeCD with even more applications by creating custom plugins for their deployments. +- Apart from Kubernetes applications, PipeCD also provides a unified interface for other cloud services (GCP Cloud Run, AWS ECS, AWS Lambda and more). Starting PipeCD v1, users can use PipeCD with even more applications by creating custom plugins for their deployments. Here are some standout features of PipeCD when compared to ArgoCD: - One tool for both GitOps sync and progressive deployment - Don't need another CRD or changing the existing manifests for doing Canary/BlueGreen. PipeCD just uses the standard Kubernetes deployment object - Easier and safer to operate multi-tenancy, multi-cluster for multiple teams (even some teams are running in a private/restricted network) - Has built-in secrets management -- Shows the delivery performance insights +- Shows the delivery performance insights -### 7. What should I do if I lose my Piped key? +### 7. What should I do if I lose my `piped` key? -You can create a new Piped key. Go to the `Piped` tab at `Settings` page, and click the vertical ellipsis of the Piped that you would like to create the new Piped key. Don't forget deleting the old Key, too. +You can create a new `piped` key. Go to the `piped` tab at `Settings` page, and click the vertical ellipsis of the `piped` that you would like to create the new `piped` key. Don't forget to delete the old key, too. ### 8. What is the strong point if PipeCD is used only for Kubernetes? - Simple interface, easy to understand no extra CRD required -- Easy to install, upgrade, and manage (both the ControlPlane and the agent Piped) +- Easy to install, upgrade, and manage (both the Control Plane and the agent `piped`) - Not strict depend on any Kubernetes API, not being part of issues for your Kubernetes cluster versioning upgrade - Easy to interact with any CI; Plan preview feature gives you an early look at what will be changed in your cluster even before manifests update - Insights show metrics like lead time, deployment frequency, MTTR, and change failure rate to measure delivery performance @@ -70,7 +70,7 @@ You can create a new Piped key. Go to the `Piped` tab at `Settings` page, and cl Yes, PipeCD is fully open source project with APACHE LICENSE, VERSION 2.0 -### 10. How should I investigate high CPU usage or memory usage in piped, or when OOM occurs? +### 10. How should I investigate high CPU usage or memory usage in `piped`, or when OOM occurs? -If you're noticing high CPU usage, memory usage, or facing OOM issues in Piped, you can use the built-in support for `pprof`, a tool for visualization and analysis of profiling data. -`pprof` can help you identify the parts of your application that are consuming the most resources. For more detailed information and examples of how to use `pprof` in Piped, please see [Using Pprof in Piped](../managing-piped/using-pprof-in-piped). +If you're noticing high CPU usage, memory usage, or facing OOM issues in `piped`, you can use the built-in support for `pprof`, a tool for visualization and analysis of profiling data. +`pprof` can help you identify the parts of your application that are consuming the most resources. For more detailed information and examples of how to use `pprof` in `piped`, please see [Using Pprof in `piped`](../managing-piped/using-pprof-in-piped). diff --git a/docs/content/en/docs-v1.0.x/installation/_index.md b/docs/content/en/docs-v1.0.x/installation/_index.md index 93a2312b9d..6f3559baea 100644 --- a/docs/content/en/docs-v1.0.x/installation/_index.md +++ b/docs/content/en/docs-v1.0.x/installation/_index.md @@ -6,17 +6,17 @@ description: > Complete guideline for installing and configuring PipeCD on your own. --- -Before starting to install PipeCD, let’s have a look at PipeCD’s components, determine your role, and which components you will interact with while installing/using PipeCD. You’re recommended to read about PipeCD’s [Control Plane](../concepts/#control-plane) and [Piped](../concepts/#piped) on the concepts page. +Before starting to install PipeCD, let's have a look at PipeCD's components, determine your role, and which components you will interact with while installing/using PipeCD. You're recommended to read about PipeCD's [Control Plane](../concepts/#control-plane) and [`piped`](../concepts/#piped) on the concepts page. ![](/images/architecture-overview-with-roles.png)

PipeCD's components with roles

-Basically, there are two types of users/roles that exist in the PipeCD system, which are: +Basically, there are two types of users/roles that exist in the PipeCD system: -- Developers/Production team: Users who use PipeCD to manage their applications’ deployments. You will interact with Piped and may or may not need to install Piped by yourself. +- Developers/Production team: Users who use PipeCD to manage their applications' deployments. You will interact with `piped` and may or may not need to install `piped` by yourself. -- Operators/Platform team: Users who operate the PipeCD for other developers can use it. You will interact with the Control Plane and Piped, you will be the one who installs the Control Plane and keeps it up for other Pipeds to connect while managing their applications’ deployments. +- Operators/Platform team: Users who operate PipeCD for other developers. You will interact with the Control Plane and `piped`, you will be the one who installs the Control Plane and keeps it up for other `piped` instances to connect while managing their applications' deployments. -This section contains the guideline for installing PipeCD's Control Plane and Piped step by step. You can choose what to read based on your roles. +This section contains guidelines for installing PipeCD's Control Plane and `piped` step by step. You can choose what to read based on your roles. diff --git a/docs/content/en/docs-v1.0.x/installation/install-control-plane/_index.md b/docs/content/en/docs-v1.0.x/installation/install-control-plane/_index.md index fe68c06c8f..548e8adcb3 100644 --- a/docs/content/en/docs-v1.0.x/installation/install-control-plane/_index.md +++ b/docs/content/en/docs-v1.0.x/installation/install-control-plane/_index.md @@ -6,4 +6,4 @@ description: > This page describes how to install a control plane. --- -Since Control Plane is a centralized component managing deployment data and provides gRPC API, it needs some components fo storing data or credential... and so on. We explain how to deploy Control Plane components. +Since Control Plane is a centralized component managing deployment data and provides gRPC API, it needs some components for storing data or credentials, and so on. We explain how to deploy Control Plane components. diff --git a/docs/content/en/docs-v1.0.x/installation/install-control-plane/installing-controlplane-on-ECS.md b/docs/content/en/docs-v1.0.x/installation/install-control-plane/installing-controlplane-on-ECS.md index acf89b201e..6c499b9910 100644 --- a/docs/content/en/docs-v1.0.x/installation/install-control-plane/installing-controlplane-on-ECS.md +++ b/docs/content/en/docs-v1.0.x/installation/install-control-plane/installing-controlplane-on-ECS.md @@ -6,7 +6,7 @@ description: > This page describes how to install control plane on ECS. --- -Currently, we provide the example of deploying Control Plane to ECS using terraform. +Currently, we provide an example of deploying Control Plane to ECS using Terraform. Please refer to the blog post :) [PipeCD best practice 02 - control plane on ECS]({{< ref "/blog/control-plane-on-ecs.md" >}} "PipeCD best practice 02 - control plane on ECS"). diff --git a/docs/content/en/docs-v1.0.x/installation/install-control-plane/installing-controlplane-on-k8s.md b/docs/content/en/docs-v1.0.x/installation/install-control-plane/installing-controlplane-on-k8s.md index b41a8c71bd..ddb51d6f94 100644 --- a/docs/content/en/docs-v1.0.x/installation/install-control-plane/installing-controlplane-on-k8s.md +++ b/docs/content/en/docs-v1.0.x/installation/install-control-plane/installing-controlplane-on-k8s.md @@ -8,14 +8,14 @@ description: > ## Prerequisites -- Having a running Kubernetes cluster +- A running Kubernetes cluster - Installed [Helm](https://helm.sh/docs/intro/install/) (3.8.0 or later) ## Installation ### 1. Preparing an encryption key -PipeCD requires a key for encrypting sensitive data or signing JWT token while authenticating. You can use one of the following commands to generate an encryption key. +PipeCD requires a key for encrypting sensitive data or signing JWT tokens while authenticating. You can use one of the following commands to generate an encryption key. ``` console openssl rand 64 | base64 > encryption-key @@ -31,11 +31,11 @@ cat /dev/urandom | head -c64 | base64 > encryption-key Control Plane Architecture

-The Control Plane of PipeCD is constructed by several components, as shown in the above graph (for more in detail please read [Control Plane architecture overview docs](../../../user-guide/managing-controlplane/architecture-overview/)). As mentioned in the graph, the PipeCD's data can be stored in one of the provided fully-managed or self-managed services. So you have to decide which kind of [data store](../../../user-guide/managing-controlplane/architecture-overview/#data-store) and [file store](../../../user-guide/managing-controlplane/architecture-overview/#file-store) you want to use and prepare a Control Plane configuration file suitable for that choice. +The Control Plane of PipeCD is constructed by several components, as shown in the above graph (for more details please read [Control Plane architecture overview docs](../../../user-guide/managing-controlplane/architecture-overview/)). As mentioned in the graph, PipeCD's data can be stored in one of the provided fully-managed or self-managed services. So you have to decide which kind of [data store](../../../user-guide/managing-controlplane/architecture-overview/#data-store) and [file store](../../../user-guide/managing-controlplane/architecture-overview/#file-store) you want to use and prepare a Control Plane configuration file suitable for that choice. #### Using Firestore and GCS -PipeCD requires a GCS bucket and service account files to access Firestore and GCS service. Here is an example of configuration file: +PipeCD requires a GCS bucket and service account files to access Firestore and GCS service. Here is an example configuration file: ``` yaml apiVersion: "pipecd.dev/v1beta1" @@ -49,20 +49,20 @@ spec: environment: dev project: {YOUR_GCP_PROJECT_NAME} # Must be a service account with "Cloud Datastore User" and "Cloud Datastore Index Admin" roles - # since PipeCD needs them to creates the needed Firestore composite indexes in the background. + # since PipeCD needs them to create the needed Firestore composite indexes in the background. credentialsFile: /etc/pipecd-secret/firestore-service-account filestore: type: GCS config: bucket: {YOUR_BUCKET_NAME} # Must be a service account with "Storage Object Admin (roles/storage.objectAdmin)" role on the given bucket - # since PipeCD need to write file object such as deployment log file to that bucket. + # since PipeCD needs to write file objects such as deployment log files to that bucket. credentialsFile: /etc/pipecd-secret/gcs-service-account ``` -See [ConfigurationReference](../../../user-guide/managing-controlplane/configuration-reference/) for the full configuration. +See [Configuration reference](../../../user-guide/managing-controlplane/configuration-reference/) for the full configuration. -After all, install the Control Plane as bellow: +After all, install the Control Plane as below: ``` console helm upgrade -i pipecd oci://ghcr.io/pipe-cd/chart/pipecd --version {{< blocks/latest_version >}} --namespace={NAMESPACE} \ @@ -72,11 +72,11 @@ helm upgrade -i pipecd oci://ghcr.io/pipe-cd/chart/pipecd --version {{< blocks/l --set-file secret.gcsServiceAccount.data=path-to-service-account-file ``` -Currently, besides `Firestore` PipeCD supports other databases as its datastore such as `MySQL`. Also as for filestore, PipeCD supports `AWS S3` and `MINIO` either. +Currently, besides `Firestore` PipeCD supports other databases as its datastore such as `MySQL`. As for filestore, PipeCD supports `AWS S3` and `MINIO` as well. -For example, in case of using `MySQL` as datastore and `MINIO` as filestore, the ControlPlane configuration will be as follow: +For example, in case of using `MySQL` as datastore and `MINIO` as filestore, the Control Plane configuration will be as follows: -```yaml +``` yaml apiVersion: "pipecd.dev/v1beta1" kind: ControlPlane spec: @@ -96,42 +96,42 @@ spec: autoCreateBucket: true ``` -You can find required configurations to use other datastores and filestores from [ConfigurationReference](../../../user-guide/managing-controlplane/configuration-reference/). +You can find required configurations to use other datastores and filestores from [Configuration reference](../../../user-guide/managing-controlplane/configuration-reference/). -__Caution__: In case of using `MySQL` as Control Plane's datastore, please note that the implementation of PipeCD requires some features that only available on [MySQL v8](https://dev.mysql.com/doc/refman/8.0/en/), make sure your MySQL service is satisfied the requirement. +__Caution__: In case of using `MySQL` as Control Plane's datastore, please note that the implementation of PipeCD requires some features that are only available in [MySQL v8](https://dev.mysql.com/doc/refman/8.0/en/), make sure your MySQL service satisfies the requirement. ### 3. Accessing the PipeCD web -If your installation was including an [ingress](https://github.com/pipe-cd/pipecd/blob/master/manifests/pipecd/values.yaml#L7), the PipeCD web can be accessed by the ingress's IP address or domain. +If your installation includes an [ingress](https://github.com/pipe-cd/pipecd/blob/master/manifests/pipecd/values.yaml#L7), the PipeCD web can be accessed by the ingress's IP address or domain. Otherwise, private PipeCD web can be accessed by using `kubectl port-forward` to expose the installed Control Plane on your localhost: ``` console kubectl port-forward svc/pipecd 8080 --namespace={NAMESPACE} ``` -Now go to [http://localhost:8080](http://localhost:8080) on your browser, you will see a page to login to your project. +Now go to [http://localhost:8080](http://localhost:8080) on your browser, you will see a page to log in to your project. -Up to here, you have a installed PipeCD's Control Plane. To logging in, you need to initialize a new project. +Up to here, you have an installed PipeCD's Control Plane. To log in, you need to initialize a new project. ### 4. Initialize a new project -To create a new project, you need to access to the `ops` pod in your installed PipeCD control plane, using `kubectl port-forward` command: +To create a new project, you need to access the `ops` pod in your installed PipeCD control plane, using `kubectl port-forward` command: -```console +``` console kubectl port-forward service/pipecd-ops 9082 --namespace={NAMESPACE} ``` -Then, access to [http://localhost:9082](http://localhost:9082). +Then, access [http://localhost:9082](http://localhost:9082). On that page, you will see the list of registered projects and a link to register new projects. Registering a new project requires only a unique ID string and an optional description text. -Once a new project has been registered, a static admin (username, password) will be automatically generated for the project admin, you can use that to login via the login form in the above section. +Once a new project has been registered, a static admin (username, password) will be automatically generated for the project admin, you can use that to log in via the login form in the above section. For more about adding a new project in detail, please read the following [docs](../../../user-guide/managing-controlplane/adding-a-project/). ### 4'. Upgrade Control Plane version -To upgrade the PipeCD Control Plane, preparations and commands remain as you do when installing PipeCD Control Plane. Only need to change the version flag in command to the specified version you want to upgrade your PipeCD Control Plane to. +To upgrade the PipeCD Control Plane, preparations and commands remain as you do when installing PipeCD Control Plane. You only need to change the version flag in command to the specified version you want to upgrade your PipeCD Control Plane to. ``` console helm upgrade -i pipecd oci://ghcr.io/pipe-cd/chart/pipecd --version {NEW_VERSION} --namespace={NAMESPACE} \ @@ -151,7 +151,7 @@ This part provides guidance for a production hardened deployment of the control - End-to-End TLS - After switching to HTTPs, do not forget to set the `api.args.secureCookie` parameter to be `true` to disallow using cookie on unsecured HTTP connection. + After switching to HTTPS, do not forget to set the `api.args.secureCookie` parameter to be `true` to disallow using cookies on unsecured HTTP connection. Alternatively in the case of GKE Ingress, PipeCD also requires a TLS certificate for internal use. This can be a self-signed one and generated by this command: @@ -160,9 +160,9 @@ This part provides guidance for a production hardened deployment of the control ``` Those key and cert can be configured via [`secret.internalTLSKey.data`](https://github.com/pipe-cd/pipecd/blob/master/manifests/pipecd/values.yaml#L118) and [`secret.internalTLSCert.data`](https://github.com/pipe-cd/pipecd/blob/master/manifests/pipecd/values.yaml#L121). - To enable internal tls connection, please set the `gateway.internalTLS.enabled` parameter to be `true`. + To enable internal TLS connection, please set the `gateway.internalTLS.enabled` parameter to be `true`. - Otherwise, the `cloud.google.com/app-protocols` annotation is also should be configured as the following: + Otherwise, the `cloud.google.com/app-protocols` annotation should also be configured as the following: ``` yaml service: diff --git a/docs/content/en/docs-v1.0.x/installation/install-piped/_index.md b/docs/content/en/docs-v1.0.x/installation/install-piped/_index.md index cb60a84f63..97c968f0da 100644 --- a/docs/content/en/docs-v1.0.x/installation/install-piped/_index.md +++ b/docs/content/en/docs-v1.0.x/installation/install-piped/_index.md @@ -1,11 +1,11 @@ --- -title: "Install Piped" -linkTitle: "Install Piped" +title: "Install piped" +linkTitle: "Install piped" weight: 3 description: > - This page describes how you can run the `piped` binary connects your infrastructure to the PipeCD Control Plane. + This page describes how you can run the `piped` binary that connects your infrastructure to the PipeCD Control Plane. --- -Since Piped is a stateless agent, no database or storage is required to run. In addition, a Piped can interact with one or multiple platform providers, so the number of `piped`'s and where they should run is entirely up to your preference. For example, you can run your Pipeds in a Kubernetes cluster to deploy not just Kubernetes applications but your Terraform and Cloud Run applications as well. +Since `piped` is a stateless agent, no database or storage is required to run. In addition, a `piped` can interact with one or multiple plugins, so the number of `piped` instances and where they should run is entirely up to your preference. For example, you can run your `piped` instances in a Kubernetes cluster to deploy not just Kubernetes applications but your Terraform and Cloud Run applications as well. In this guide, we will see how you can configure your `piped` agent and install it on different platforms. diff --git a/docs/content/en/docs-v1.0.x/installation/install-piped/installing-on-kubernetes.md b/docs/content/en/docs-v1.0.x/installation/install-piped/installing-on-kubernetes.md index d88b1f9a4a..28c9590e94 100644 --- a/docs/content/en/docs-v1.0.x/installation/install-piped/installing-on-kubernetes.md +++ b/docs/content/en/docs-v1.0.x/installation/install-piped/installing-on-kubernetes.md @@ -3,7 +3,7 @@ title: "Installing on a Kubernetes cluster" linkTitle: "Installing on a Kubernetes cluster" weight: 1 description: > - This page describes how install Piped on a Kubernetes cluster. + This page describes how to install `piped` on a Kubernetes cluster. --- ## Prerequisites @@ -11,29 +11,29 @@ description: > ### A registered `piped` - Make sure your `piped` is registered in the Control Plane and that you have its **PIPED_ID** and **PIPED_KEY**. -- If not, follow the guide to [register a new `Piped`](../../../user-guide/managing-controlplane/registering-a-piped/). +- If not, follow the guide to [register a new `piped`](../../../user-guide/managing-controlplane/registering-a-piped/). ### SSH Key for Git Repositories - If your Git repositories are private, `piped` requires a private SSH key to access those repositories. -- Please checkout [this documentation](https://help.github.com/en/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent) for how to generate a new SSH key pair. Then add the public key to your repositories. (If you are using GitHub, you can add it to Deploy Keys at the repository's Settings page.) +- Please check out [this documentation](https://help.github.com/en/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent) for how to generate a new SSH key pair. Then add the public key to your repositories. (If you are using GitHub, you can add it to Deploy Keys at the repository's Settings page.) If your Git repositories are private, `piped` needs an SSH key to access them. - Generate a new SSH key pair by following [GitHub’s guide to generating an SSH Key](https://help.github.com/en/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent). ->Note: ->If you are using GitHub, add the **public key** as a deploy key to your repositories. +> **Note:** +> If you are using GitHub, add the **public key** as a deploy key to your repositories. ## Installation -### Preparing the `Piped` configuaration file +### Preparing the `piped` configuration file - Plugins are external binaries that have to be referenced in the piped configuration file. There are no plugins set by default. +Plugins are external binaries that have to be referenced in the `piped` configuration file. There are no plugins set by default. -An example of the a piped V1 configuration file using the Kubernetes plugin: +An example of a `piped` v1 configuration file using the Kubernetes plugin: -```yaml +``` yaml apiVersion: pipecd.dev/v1beta1 kind: Piped spec: @@ -50,13 +50,13 @@ spec: ``` >**Note:** ->`Piped`'s plugins are versioned independently from PipeCD. See the [latest releases](https://github.com/pipe-cd/pipecd/releases) for more information. +> `piped`'s plugins are versioned independently from PipeCD. See the [latest releases](https://github.com/pipe-cd/pipecd/releases) for more information. > >We now also have a repository for community built plugins. See the [Community plugins repository on GitHub](https://github.com/pipe-cd/community-plugins) to know more. ## In the cluster-wide mode -This way requires installing cluster-level resources. Piped installed with this way can perform deployment workloads against any other namespaces than the where Piped runs on. +This way requires installing cluster-level resources. When installed this way, `piped` can perform deployment workloads against any other namespaces than the namespace where `piped` runs. - Preparing a piped configuration file as the following @@ -78,14 +78,14 @@ This way requires installing cluster-level resources. Piped installed with this syncInterval: 1m ``` -See [ConfigurationReference](../../../user-guide/managing-piped/configuration-reference/) for the full configuration. +See [Configuration reference](../../../user-guide/managing-piped/configuration-reference/) for the full configuration. - Installing by using [Helm](https://helm.sh/docs/intro/install/) (3.8.0 or later) {{< tabpane >}} - {{< tab lang="bash" header="Piped" >}} -# This command just installs a Piped with the specified version. -# Whenever you want to upgrade that Piped to a new version or update its config data + {{< tab lang="bash" header="piped" >}} +# This command just installs a `piped` with the specified version. +# Whenever you want to upgrade that `piped` to a new version or update its config data # you have to restart it by re-running this command. helm upgrade -i dev-piped oci://ghcr.io/pipe-cd/chart/piped --version={{< blocks/latest_version >}} --namespace={NAMESPACE} \ @@ -96,20 +96,20 @@ helm upgrade -i dev-piped oci://ghcr.io/pipe-cd/chart/piped --version={{< blocks {{< /tabpane >}} - Note: Be sure to set `--set args.insecure=true` if your Control Plane has not TLS-enabled yet. + Note: Be sure to set `--set args.insecure=true` if your Control Plane does not have TLS enabled yet. See [values.yaml](https://github.com/pipe-cd/pipecd/blob/master/manifests/piped/values.yaml) for the full values. ## In the namespaced mode -The previous way requires installing cluster-level resources. If you want to restrict Piped's permission within the namespace where Piped runs on, you can configure it using the scope parameter. +The previous way requires installing cluster-level resources. If you want to restrict `piped`'s permission within the namespace where `piped` runs, you can configure it using the scope parameter. - Installing by using [Helm](https://helm.sh/docs/intro/install/) (3.8.0 or later) {{< tabpane >}} - {{< tab lang="bash" header="Piped" >}} -# This command just installs a Piped with the specified version. -# Whenever you want to upgrade that Piped to a new version or update its config data + {{< tab lang="bash" header="piped" >}} +# This command just installs a `piped` with the specified version. +# Whenever you want to upgrade that `piped` to a new version or update its config data # you have to restart it by re-running this command. helm upgrade -i dev-piped oci://ghcr.io/pipe-cd/chart/piped --version={{< blocks/latest_version >}} --namespace={NAMESPACE} \ @@ -120,7 +120,7 @@ helm upgrade -i dev-piped oci://ghcr.io/pipe-cd/chart/piped --version={{< blocks {{< /tab >}} {{< /tabpane >}} -## In case on OpenShift less than 4.2 +## For OpenShift less than 4.2 OpenShift uses an arbitrarily assigned user ID when it starts a container. Starting from OpenShift 4.2, it also inserts that user into `/etc/passwd` for using by the application inside the container, @@ -130,11 +130,11 @@ Therefore if you are running on OpenShift with a version before 4.2, please use - Installing by using [Helm](https://helm.sh/docs/intro/install/) (3.8.0 or later) {{< tabpane >}} - {{< tab lang="bash" header="Piped" >}} + {{< tab lang="bash" header="piped" >}} -# This command just installs a Piped with the specified version. +# This command just installs a `piped` with the specified version. -# Whenever you want to upgrade that Piped to a new version or update its config data +# Whenever you want to upgrade that `piped` to a new version or update its config data # you have to restart it by re-running this command. diff --git a/docs/content/en/docs-v1.0.x/installation/install-piped/installing-on-single-machine.md b/docs/content/en/docs-v1.0.x/installation/install-piped/installing-on-single-machine.md index 54423d52ee..a205648af2 100644 --- a/docs/content/en/docs-v1.0.x/installation/install-piped/installing-on-single-machine.md +++ b/docs/content/en/docs-v1.0.x/installation/install-piped/installing-on-single-machine.md @@ -3,7 +3,7 @@ title: "Installing on a single machine" linkTitle: "Installing on a single machine" weight: 5 description: > - This page describes how to install a Piped on a single machine. + This page describes how to install `piped` on a single machine. --- @@ -12,33 +12,33 @@ description: > ### A registered `piped` - Make sure your `piped` is registered in the Control Plane and that you have its **PIPED_ID** and **PIPED_KEY**. -- If not, follow the guide to [register a new `Piped`](../../../user-guide/managing-controlplane/registering-a-piped/). +- If not, follow the guide to [register a new `piped`](../../../user-guide/managing-controlplane/registering-a-piped/). ### SSH Key for Git Repositories - If your Git repositories are private, `piped` requires a private SSH key to access those repositories. -- Please checkout [this documentation](https://help.github.com/en/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent) for how to generate a new SSH key pair. Then add the public key to your repositories. (If you are using GitHub, you can add it to Deploy Keys at the repository's Settings page.) +- Please check out [this documentation](https://help.github.com/en/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent) for how to generate a new SSH key pair. Then add the public key to your repositories. (If you are using GitHub, you can add it to Deploy Keys at the repository's Settings page.) If your Git repositories are private, `piped` needs an SSH key to access them. - Generate a new SSH key pair by following [GitHub’s guide to generating an SSH Key](https://help.github.com/en/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent). ->Note: ->If you are using GitHub, add the **public key** as a deploy key to your repositories. +> **Note:** +> If you are using GitHub, add the **public key** as a deploy key to your repositories. -### Install the `piped` V1 binary +### Install the `piped` v1 binary -Download the latest `piped` V1. See the [latest releases](https://github.com/pipe-cd/pipecd/releases) and find out the right binary for your machine. +Download the latest `piped` v1. See the [latest releases](https://github.com/pipe-cd/pipecd/releases) and find out the right binary for your machine. ## Installation -### Preparing the `Piped` configuaration file +### Preparing the `piped` configuration file -Plugins are external binaries that have to be referenced in the piped configuration file. There are no plugins set by default. +Plugins are external binaries that have to be referenced in the `piped` configuration file. There are no plugins set by default. -An example of the a piped V1 configuration file using the [Example-stage plugin](https://github.com/pipe-cd/community-plugins/tree/main/plugins/example-stage): +An example of a `piped` v1 configuration file using the [Example-stage plugin](https://github.com/pipe-cd/community-plugins/tree/main/plugins/example-stage): -```yaml +``` yaml apiVersion: pipecd.dev/v1beta1 kind: Piped spec: @@ -54,19 +54,19 @@ spec: plugins: {} ``` -See [ConfigurationReference](../../../user-guide/managing-piped/configuration-reference/) for the full configuration. +See [Configuration reference](../../../user-guide/managing-piped/configuration-reference/) for the full configuration. >**Note:** ->`Piped`'s plugins are versioned independently from PipeCD. Official plugins are maintained and monitored by the PipeCD Maintainers. See the [latest releases](https://github.com/pipe-cd/pipecd/releases) for more information. +> `piped`'s plugins are versioned independently from PipeCD. Official plugins are maintained and monitored by the PipeCD Maintainers. See the [latest releases](https://github.com/pipe-cd/pipecd/releases) for more information. > >We now also have a repository for community built plugins. See the [Community plugins repository on GitHub](https://github.com/pipe-cd/community-plugins) to know more. ## Run the `piped` -After you have configured your Piped configuration file, execute the `piped` binary and specify the path to the Piped configuration file. +After you have configured your `piped` configuration file, execute the `piped` binary and specify the path to the `piped` configuration file. - ``` console - #Replace `` with the path to your Piped configuration file. + ```console + #Replace `` with the path to your `piped` configuration file. ./piped pipedv1 --config-file={PATH_TO_PIPED_CONFIG_FILE} ``` diff --git a/docs/content/en/docs-v1.0.x/migrating-from-v0-to-v1/_index.md b/docs/content/en/docs-v1.0.x/migrating-from-v0-to-v1/_index.md index 147745da9e..afe8067770 100644 --- a/docs/content/en/docs-v1.0.x/migrating-from-v0-to-v1/_index.md +++ b/docs/content/en/docs-v1.0.x/migrating-from-v0-to-v1/_index.md @@ -22,8 +22,8 @@ The PipeCD System has 2 main components: | Component | Description | Compatibility | |------------|--------------|----------------| -| **Control Plane** | Manages projects, deployments, and applications. | Supports both piped and pipedv1 concurrently. | -| **Piped** | Manages the actual deployment and syncing of applications. | Backward compatible - You can switch back to old piped versions. | +| **Control Plane** | Manages projects, deployments, and applications. | Supports both `piped` and pipedv1 concurrently. | +| **`piped`** | Manages the actual deployment and syncing of applications. | Backward compatible - You can switch back to old `piped` versions. | --- @@ -235,13 +235,13 @@ Example: - [v1.0.0-rc3](https://github.com/pipe-cd/pipecd/releases/tag/pipedv1%2Fexp%2Fv1.0.0-rc3) >**Warning:** -> Before switching to `pipedv1`, stop your existing Piped process to avoid conflicts, as both versions use the same `piped-id`. +> Before switching to `pipedv1`, stop your existing `piped` process to avoid conflicts, as both versions use the same `piped-id`. Once you have prepared your pipedv1 configuration, there are a few different ways to deploy it. ### Option 1 - Deploy via Helm (Kubernetes) -If you are deploying Piped as a pod in a Kubernetes cluster, use the following Helm command: +If you are deploying `piped` as a pod in a Kubernetes cluster, use the following Helm command: ```bash helm upgrade -i pipedv1-exp oci://ghcr.io/pipe-cd/chart/pipedv1-exp \ diff --git a/docs/content/en/docs-v1.0.x/overview/_index.md b/docs/content/en/docs-v1.0.x/overview/_index.md index ad28a67b4e..ab099bbf08 100644 --- a/docs/content/en/docs-v1.0.x/overview/_index.md +++ b/docs/content/en/docs-v1.0.x/overview/_index.md @@ -6,7 +6,7 @@ description: > Overview about PipeCD. --- -![PipeCD explaination](/images/pipecd-explanation.png) +![PipeCD explanation](/images/pipecd-explanation.png)

PipeCD - a GitOps style continuous delivery solution

@@ -14,12 +14,12 @@ PipeCD - a GitOps style continuous delivery solution ## What Is PipeCD? {{% pageinfo %}} -PipeCD provides a unified continuous delivery solution for multiple application kinds on multi-cloud that empowers engineers to deploy faster with more confidence, a GitOps tool that enables doing deployment operations by pull request on Git. +PipeCD provides a unified continuous delivery solution for multiple application kinds on multi-cloud that empowers engineers to deploy faster with more confidence, a GitOps tool that enables deployment operations by pull request on Git. {{% /pageinfo %}} ## Why PipeCD? -- Simple, unified and easy to use but powerful pipeline definition to construct your deployment +- Simple, unified and easy to use, but powerful pipeline definition to construct your deployment - Same deployment interface to deploy applications of any platform, including Kubernetes, Terraform, GCP Cloud Run, AWS Lambda, AWS ECS and more. - Offers extensibility with a plugin-architecture, allowing users to create plugins and deploy custom applications - No CRD or applications' manifest changes are required; Only need a pipeline definition along with your application manifests @@ -27,16 +27,16 @@ PipeCD provides a unified continuous delivery solution for multiple application - Built-in deployment analysis as part of the deployment pipeline to measure impact based on metrics, logs, emitted requests - Easy to interact with any CI; The CI tests and builds artifacts, PipeCD takes the rest - Insights show metrics like lead time, deployment frequency, MTTR and change failure rate to measure delivery performance -- Designed to manage thousands of cross-platform applications in multi-cloud for company scale but also work well for small projects +- Designed to manage thousands of cross-platform applications in multi-cloud at company scale but also works well for small projects ## PipeCD's Characteristics in detail **Visibility** -- Deployment pipeline UI shows clarify what is happening +- Deployment pipeline UI shows clearly what is happening - Separate logs viewer for each individual deployment -- Realtime visualization of application state -- Deployment notifications to slack, webhook endpoints +- Real-time visualization of application state +- Deployment notifications to Slack, webhook endpoints - Insights show metrics like lead time, deployment frequency, MTTR and change failure rate to measure delivery performance **Automation** @@ -48,16 +48,16 @@ PipeCD provides a unified continuous delivery solution for multiple application **Safety and Security** -- Support single sign-on and role-based access control +- Supports single sign-on and role-based access control - Credentials are not exposed outside the cluster and not saved in the Control Plane -- Piped makes only outbound requests and can run inside a restricted network +- `piped` makes only outbound requests and can run inside a restricted network - Built-in secrets management **Multi-provider & Multi-Tenancy** -- Support multiple application kinds on multi-cloud including Kubernetes, Terraform, Cloud Run, AWS Lambda, Amazon ECS and more with plugins. -- Support multiple analysis providers including Prometheus, Datadog, Stackdriver, and more -- Easy to operate multi-cluster, multi-tenancy by separating Control Plane and Piped +- Supports multiple application kinds on multi-cloud including Kubernetes, Terraform, Cloud Run, AWS Lambda, Amazon ECS and more with plugins. +- Supports multiple analysis providers including Prometheus, Datadog, Stackdriver, and more +- Easy to operate multi-cluster, multi-tenancy by separating Control Plane and `piped` **Open Source** @@ -68,14 +68,14 @@ PipeCD provides a unified continuous delivery solution for multiple application For a good understanding of the PipeCD's components. -- [Concepts](../concepts): describes each components. +- [Concepts](../concepts): describes each component. - [FAQ](../faq): describes the difference between PipeCD and other tools. If you are an **operator** wanting to install and configure PipeCD for other developers. - [Quickstart](../quickstart/) - [Managing Control Plane](../user-guide/managing-controlplane/) -- [Managing Piped](../user-guide/managing-piped/) +- [Managing `piped`](../user-guide/managing-piped/) If you are a **user** using PipeCD to deploy your application/infrastructure: diff --git a/docs/content/en/docs-v1.0.x/quickstart/_index.md b/docs/content/en/docs-v1.0.x/quickstart/_index.md index 4d1ca13d6e..e3a3c45281 100644 --- a/docs/content/en/docs-v1.0.x/quickstart/_index.md +++ b/docs/content/en/docs-v1.0.x/quickstart/_index.md @@ -6,18 +6,18 @@ description: > This page describes how to quickly get started with PipeCD on Kubernetes. --- -PipeCD consists of two core components: The Control Plane and Piped (see [PipeCD Concepts](../concepts/)). +PipeCD consists of two core components: The Control Plane and `piped` (see [PipeCD Concepts](../concepts/)). - **The Control Plane** can be thought of as a web service application that can be installed anywhere. It provides the web UI, API endpoints, and metadata storage. -- **Piped** is a lightweight binary agent that connects your infrastructure to the Control Plane. Piped runs plugins internally which implement the deployment and synchronization logic for a specific application kind, such as Kubernetes or Terraform. +- **`piped`** is a lightweight binary agent that connects your infrastructure to the Control Plane. `piped` runs plugins internally which implement the deployment and synchronization logic for a specific application kind, such as Kubernetes or Terraform. In this quickstart, you’ll install both components on a Kubernetes cluster and deploy a sample “hello world” application. ->Note: +> **Note:** > ->- It's not required to install the PipeCD control plane to the cluster where your applications are running (See [PipeCD best practices](/blog/2021/12/29/pipecd-best-practice-01-operate-your-own-pipecd-cluster/) to understand more about PipeCD in real life use cases). ->- If you want to experiment with PipeCD freely or don't have a Kubernetes cluster, we recommend using [this Tutorial](https://github.com/pipe-cd/tutorial). +>- It's not required to install the PipeCD control plane to the cluster where your applications are running (See [PipeCD best practices](/blog/2021/12/29/pipecd-best-practice-01-operate-your-own-pipecd-cluster/) to understand more about PipeCD in real-life use cases). +>- If you want to experiment with PipeCD freely or don't have a Kubernetes cluster, we recommend using [this tutorial](https://github.com/pipe-cd/tutorial). --- @@ -37,7 +37,7 @@ kubectl create namespace pipecd kubectl apply -n pipecd -f https://raw.githubusercontent.com/pipe-cd/pipecd/master/quickstart/manifests/control-plane.yaml ``` -The PipeCD control plane will be installed with a default project named `quickstart`. To access the PipeCD Control Plane UI, run the following command +The PipeCD control plane will be installed with a default project named `quickstart`. To access the PipeCD Control Plane UI, run the following command: ```bash kubectl port-forward -n pipecd svc/pipecd 8080 @@ -45,32 +45,32 @@ kubectl port-forward -n pipecd svc/pipecd 8080 You can access the PipeCD console at [http://localhost:8080?project=quickstart](http://localhost:8080?project=quickstart) -To login, you can use the configured static admin account as below: +To log in, you can use the configured static admin account as below: - username: `hello-pipecd` - password: `hello-pipecd` -And you will access the main page of PipeCD Control Plane console, which looks like this +And you will access the main page of PipeCD Control Plane console, which looks like this: ![An image of the Control Plane](/images/pipecd-control-plane-mainpage.png) -For more about PipeCD control plane management, please check [Managing ControlPlane](/docs/user-guide/managing-controlplane/). +For more about PipeCD control plane management, please check [Managing Control Plane](../user-guide/managing-controlplane/). -#### 1.2. Installing Piped +#### 1.2. Installing piped -Next, in order to perform CD tasks, you need to install a Piped agent to the cluster. +Next, in order to perform CD tasks, you need to install a `piped` agent to the cluster. From your logged in tab, navigate to the PipeCD setting page at [http://localhost:8080/settings/piped?project=quickstart](http://localhost:8080/settings/piped?project=quickstart). -You will find the `+ADD` button around the top left of this page, click there and insert information to register the Piped agent (for example, `dev`). +You will find the `+ADD` button around the top left of this page, click there and insert information to register the `piped` agent (for example, `dev`). -![Interface to add piped](/images/quickstart-adding-piped.png) +![Interface to add `piped`](/images/quickstart-adding-piped.png) Click on the `Save` button, and then you can see the piped-id and secret-key. -![A successfully registered piped](/images/quickstart-piped-registered.png) +![A successfully registered `piped`](/images/quickstart-piped-registered.png) -You need to copy two values, `Piped Id` and `Base64 Encoded Piped Key`, and fill in `` and `` respectively this command: +You need to copy two values, ``piped Id`` and ``Base64 Encoded piped Key``, and fill in `` and `` respectively in this command: ```bash $ curl -s https://raw.githubusercontent.com/pipe-cd/pipecd/refs/heads/master/quickstart/manifests/pipedv1-exp.yaml | \ @@ -79,11 +79,11 @@ $ curl -s https://raw.githubusercontent.com/pipe-cd/pipecd/refs/heads/master/qui kubectl apply -n pipecd -f - ``` -For more information about Piped management, please check [Managing Piped](/docs/user-guide/managing-piped/). +For more information about `piped` management, please check [Managing piped](/docs/user-guide/managing-piped/). That's all! You are ready to use PipeCD to manage your application's deployment. -You can check the readiness of all PipeCD components via command +You can check the readiness of all PipeCD components via the command: ```bash $ kubectl get pod -n pipecd @@ -101,16 +101,16 @@ piped-8477b5d55d-74s5v 1/1 Running 0 97s ### 2. Deploy a Kubernetes application with PipeCD -Above is all that is necessary to set up your own PipeCD (both control plane and agent), let's use the installed one to deploy your first Kubernetes application with PipeCD. +The above is all that is necessary to set up your own PipeCD (both control plane and agent), let's use the installed one to deploy your first Kubernetes application with PipeCD. Navigate to the `Applications` page, click on the `+ADD` button on the top left corner. -Go to the `PIPED V1 ADD FROM SUGGESTIONS` tab, then select: +Go to the `PIPED v1 ADD FROM SUGGESTIONS` tab, then select: -- Piped that you have just registered (e.g. `dev`) +- `piped` that you have just registered (e.g. `dev`) - The deployment target (e.g. 'kubernetes') -You should see a lot of suggested applications. Select one of listed applications and click the `SAVE` button to register. +You should see a lot of suggested applications. Select one of the listed applications and click the `SAVE` button to register. ![Adding the application](/images/quickstart-adding-application-from-suggestions-v1.png) @@ -118,15 +118,15 @@ After a bit, the first deployment is complete and will automatically sync the ap ![Preview your deployment](/images/quickstart-first-deployment.png) -For more information on manging application deployment with PipeCD, see [Managing application](/docs/user-guide/managing-application/) +For more information on managing application deployment with PipeCD, see [Managing application](../user-guide/managing-application/) --- ### 3. Cleanup -When you’re finished experimenting with PipeCD quickstart mode, you can uninstall it using: +When you're finished experimenting with PipeCD quickstart mode, you can uninstall it using: -``` bash +```bash kubectl delete ns pipecd ``` @@ -134,6 +134,6 @@ kubectl delete ns pipecd ### What next? -To prepare your PipeCD for a production environment, please visit the [Installation](../installation/) guideline. For guidelines to use PipeCD to deploy your application in daily usage, please visit the [User guide](../user-guide/) docs. +To prepare your PipeCD for a production environment, please visit the [Installation](../installation/) guidelines. For guidelines to use PipeCD to deploy your application in daily usage, please visit the [User guide](../user-guide/) docs. To set up the development environment and start contributing to PipeCD, please visit the [Contributor guide](../contribution-guidelines/) docs. diff --git a/docs/content/en/docs-v1.0.x/user-guide/command-line-tool.md b/docs/content/en/docs-v1.0.x/user-guide/command-line-tool.md index bad930e7e0..4407899e16 100644 --- a/docs/content/en/docs-v1.0.x/user-guide/command-line-tool.md +++ b/docs/content/en/docs-v1.0.x/user-guide/command-line-tool.md @@ -11,7 +11,7 @@ You can use pipectl to add and sync applications, wait for a deployment status. ## Installation -The Pipectl command-line tool can be installed using one of the following methods: +The pipectl command-line tool can be installed using one of the following methods: ### Directly download and set up binary @@ -47,7 +47,7 @@ The Pipectl command-line tool can be installed using one of the following method About [Asdf](https://asdf-vm.com/) -1. Add pipectl plugin to asdf. (If you have not yet `asdf add plugin add pipectl`.) +1. Add pipectl plugin to asdf. (If you have not yet added the plugin, run `asdf plugin add pipectl`.) ```console asdf plugin add pipectl ``` @@ -328,7 +328,7 @@ pipectl event register \ --data=gcr.io/pipecd/example:v0.1.0 ``` -See more on [usage of Event Watcher](./event-watcher.md). +See more on [usage of Event Watcher](./managing-application/event-watcher). ### Encrypting the data you want to use when deploying @@ -355,7 +355,7 @@ You can encrypt it the same way you do [from the web](../managing-application/se --input-file={PATH_TO_SECRET_FILE} ``` -Note: The docs for pipectl available command is maybe outdated, we suggest users use the `help` command for the updated usage while using pipectl. +> **Note:** The docs for pipectl available command may be outdated. We suggest users use the `help` command for the updated usage while using pipectl. ### You want more? diff --git a/docs/content/en/docs-v1.0.x/user-guide/managing-application/_index.md b/docs/content/en/docs-v1.0.x/user-guide/managing-application/_index.md index 9e5d54d98b..6f243387d2 100644 --- a/docs/content/en/docs-v1.0.x/user-guide/managing-application/_index.md +++ b/docs/content/en/docs-v1.0.x/user-guide/managing-application/_index.md @@ -6,4 +6,4 @@ description: > This guide is for developers who have PipeCD installed for them and are using PipeCD to deploy their applications. --- -> Note: You must have at least one activated/running Piped to enable using any of the following features of PipeCD. Please refer to [Piped installation docs](../../installation/install-piped/) if you do not have any Piped in your pocket. +> **Note:** You must have at least one activated/running `piped` to enable using any of the following features of PipeCD. Please refer to [piped installation docs](../../installation/install-piped/) if you do not have any `piped` in your pocket. diff --git a/docs/content/en/docs-v1.0.x/user-guide/managing-application/adding-an-application.md b/docs/content/en/docs-v1.0.x/user-guide/managing-application/adding-an-application.md index 1b205179c5..49d1f5215c 100644 --- a/docs/content/en/docs-v1.0.x/user-guide/managing-application/adding-an-application.md +++ b/docs/content/en/docs-v1.0.x/user-guide/managing-application/adding-an-application.md @@ -11,13 +11,13 @@ It represents the service which you are going to deploy. With PipeCD, all the ap Each application is managed by exactly one `piped` instance. However, a single `piped` can manage multiple applications. -Starting PipeCD V1, you can deploy virtually any application on your desired platform using plugins. See more about [plugins](../../concepts/#plugins). Currently, the PipeCD maintainers team maintains plugins for Kubernetes and Terraform. +Starting PipeCD v1, you can deploy virtually any application on your desired platform using plugins. See more about [plugins](../../concepts/#plugins). Currently, the PipeCD maintainers team maintains plugins for Kubernetes and Terraform. ## Preparing the application configuration file -You have to **prepare a configuration file** which contains your application configuration and store that file in the Git repository which your Piped is watching first to enable adding a new application this way. The application configuration file name must be suffixed by `.pipecd.yaml` because the `piped` agent periodically checks for files with this suffix. +You have to **prepare a configuration file** which contains your application configuration and store that file in the Git repository which your `piped` is watching first to enable adding a new application this way. The application configuration file name must be suffixed by `.pipecd.yaml` because the `piped` agent periodically checks for files with this suffix. ->**Note**: Make sure that your Application Repository is listed in your `piped` configuration file. See the [`piped` configuration reference](../managing-piped/configuration-reference/#gitrepository:~:text=No-,repositories,-%5B%5DRepository) for more details. +> **Note:** Make sure that your Application Repository is listed in your `piped` configuration file. See the [`piped` Configuration reference](../managing-piped/configuration-reference/#gitrepository:~:text=No-,repositories,-%5B%5DRepository) for more details. The application configuration depends on the plugin that you are using for your deployment. Below is an example of what an application configuration file (app.pipecd.yaml) will look like. Please see [Plugins](../../concepts/#plugins) and [Application Configuration](../../concepts/#application-configuration) for more details on how to configure your `app.pipecd.yaml` in accordance with the plugin that you plan to use. @@ -44,18 +44,18 @@ Registering the application helps PipeCD know: - where the application configuration is placed - which `piped` should handle it and which platform the application should be deployed to. -You can register a new application from the web console (aka the Control Plane) by picking from a list of unused apps suggested by `pipeds` while scanning the git repositories connected to it. +You can register a new application from the web console (aka the Control Plane) by picking from a list of unused apps suggested by `piped` instances while scanning the git repositories connected to it. You can also use the `pipectl` command-line tool to configure your application in the Control Plane. See adding a new application using [`pipectl`](../../command-line-tool/#adding-a-new-application). ->**Note:** ->Manually configuring the application on the Control Plane is not supported for PipeCD v1 deployments (deployment using plugins) as of now. We are working on this feature. +> **Note:** +> Manually configuring the application on the Control Plane is not supported for PipeCD v1 deployments (deployment using plugins) as of now. We are working on this feature. - + -Go to the PipeCD web console on application list page, click the `+ADD` button at the top left corner of the application list page and then switch to the `PIPED V1 ADD FROM SUGGESTIONS` tab. +Go to the PipeCD web console on application list page, click the `+ADD` button at the top left corner of the application list page and then switch to the `PIPED v1 ADD FROM SUGGESTIONS` tab. -Select the Piped that you want to use and the deploy target that you want to deploy to. If you have configured your `piped` configuration file and the Application Repository correctly, all the applications in the target repository will be listed in the 'Select application to add' tab. Select the unregistered Application you want to deploy and click on 'SAVE'. Your application should now be successfully registered and deploying on PipeCD. +Select the `piped` that you want to use and the deploy target that you want to deploy to. If you have configured your `piped` configuration file and the Application Repository correctly, all the applications in the target repository will be listed in the 'Select application to add' tab. Select the unregistered Application you want to deploy and click on 'SAVE'. Your application should now be successfully registered and deploying on PipeCD. ![Registering an Application from Suggestions: PipeCD v1](/images/quickstart-adding-application-from-suggestions-v1.png)

@@ -79,6 +79,6 @@ spec: team: new-team ``` -Commit and push the changes. `Piped` will detect the updates and apply them automatically, according to the configured deployment pipeline. +Commit and push the changes. `piped` will detect the updates and apply them automatically, according to the configured deployment pipeline. For all available configuration options, see the [configuration reference](../configuration-reference/). diff --git a/docs/content/en/docs-v1.0.x/user-guide/managing-application/deployment-trace.md b/docs/content/en/docs-v1.0.x/user-guide/managing-application/deployment-trace.md index 42fc06b40e..6d91536567 100644 --- a/docs/content/en/docs-v1.0.x/user-guide/managing-application/deployment-trace.md +++ b/docs/content/en/docs-v1.0.x/user-guide/managing-application/deployment-trace.md @@ -8,7 +8,7 @@ description: > You are a developer who works with application code change, and don't know what deployment is triggered by your commit on PipeCD UI? This feature is for you. -If you're using PipeCD [Event Watcher](./event-watcher) to trigger the deployment for your code change, you can attach information of the triggered commit as the event data, PipeCD will use that information and helps you to make a link between your application code commit and the triggered deployments that reflect your code change. +If you're using PipeCD [Event Watcher](./event-watcher) to trigger the deployment for your code change, you can attach information of the triggered commit as the event data, PipeCD will use that information and helps you make a link between your application code commit and the triggered deployments that reflect your code change. ![Deployment Trace feature](/images/deployment-trace-ui.png) @@ -29,7 +29,7 @@ Flags: --commit-url string The URL of commit that triggers the event. ``` -Note: You have to attach at least `commit-hash` and `commit-url` as the event data in order to use the Deployment Trace feature. +> **Note:** You have to attach at least `commit-hash` and `commit-url` as the event data in order to use the Deployment Trace feature. ## Github Actions diff --git a/docs/content/en/docs-v1.0.x/user-guide/managing-application/event-watcher.md b/docs/content/en/docs-v1.0.x/user-guide/managing-application/event-watcher.md index 3bd0114f0b..e91d84ad87 100644 --- a/docs/content/en/docs-v1.0.x/user-guide/managing-application/event-watcher.md +++ b/docs/content/en/docs-v1.0.x/user-guide/managing-application/event-watcher.md @@ -12,14 +12,14 @@ The only way to upgrade your application with PipeCD is modifying configuration It brings benefits quite a bit, but it can be painful to manually update them every time in some cases (e.g. continuous deployment to your development environment for debugging, the latest prerelease to the staging environment). If you're experiencing any of the above pains, Event watcher is for you. -Event watcher works as a helper facility to seamlessly link CI and CD. This feature lets you automatically update files managed by your Piped when an arbitrary event has occurred. +Event watcher works as a helper facility to seamlessly link CI and CD. This feature lets you automatically update files managed by your `piped` when an arbitrary event has occurred. While it empowers you to build pretty versatile workflows, the canonical use case is that you trigger a new deployment by image updates, package releases, etc. This guide walks you through configuring Event watcher and how to push an Event. ## Prerequisites -Before we get into configuring EventWatcher, be sure to configure Piped. See [here](../managing-piped/configuring-event-watcher/) for more details. +Before we get into configuring EventWatcher, be sure to configure `piped`. See [here](../managing-piped/configuring-event-watcher/) for more details. ## Usage @@ -35,7 +35,7 @@ Therefore, you mainly need to: #### Use the `.pipe/` directory Prepare EventWatcher configuration files under the `.pipe/` directory at the root of your Git repository. -In that files, you define which values in which files should be updated when the Piped found out a new Event. +In those files, you define which values in which files should be updated when `piped` finds a new Event. For instance, suppose you want to update the Kubernetes manifest defined in `helloworld/deployment.yaml` when an Event with the name `helloworld-image-update` occurs: @@ -106,7 +106,7 @@ You can see the status on the event list page. ![](/images/event-list-page.png) -After a while, Piped will create a commit as shown below: +After a while, `piped` will create a commit as shown below: ```diff spec: @@ -116,7 +116,7 @@ After a while, Piped will create a commit as shown below: + image: gcr.io/pipecd/helloworld:v0.2.0 ``` -NOTE: Keep in mind that it may take a little while because Piped periodically fetches the new events from the Control Plane. You can change its interval according to [here](../managing-piped/configuration-reference/#eventwatcher). +> **Note:** Keep in mind that it may take a little while because `piped` periodically fetches the new events from the Control Plane. You can change its interval according to [here](../managing-piped/configuration-reference/#eventwatcher). ### [optional] Using labels Event watcher is a project-wide feature, hence an event name is unique inside a project. That is, you can update multiple repositories at the same time if you use the same event name for different events. @@ -225,7 +225,7 @@ pipectl event register \ --commit-url=https://github.com/pipe-cd/pipecd/commit/20c98a503062021720b2fcf2058276b3245xxxxx ``` -NOTE: There are few more information of the triggered commit you can attach as event metadata, find more in [DeploymentTrace](./deployment-trace) docs. +> **Note:** There is a bit more information about the triggered commit you can attach as event metadata. Find more in [Deployment Trace](./deployment-trace) docs. ## Examples Suppose you want to update your configuration file after releasing a new Helm chart. @@ -267,7 +267,7 @@ pipectl event register \ --data=0.2.0 ``` -Then you'll see that Piped updates as: +Then you'll see that `piped` updates as: ```diff apiVersion: pipecd.dev/v1beta1 diff --git a/docs/content/en/docs-v1.0.x/user-guide/managing-application/manifest-attachment.md b/docs/content/en/docs-v1.0.x/user-guide/managing-application/manifest-attachment.md index 8a917ef320..ae9219a02c 100644 --- a/docs/content/en/docs-v1.0.x/user-guide/managing-application/manifest-attachment.md +++ b/docs/content/en/docs-v1.0.x/user-guide/managing-application/manifest-attachment.md @@ -35,7 +35,7 @@ spec: - taskdef.yaml ``` -The `config.yaml` file is used as an attachment that can be referenced by other files. The content in `config.yaml` will be reffered to as `config`, and the target files that are configured to use the `config` can be defined under targets. In this case, it is the `taskdef.yaml` file. +The `config.yaml` file is used as an attachment that can be referenced by other files. The content in `config.yaml` will be referred to as `config`, and the target files that are configured to use the `config` can be defined under targets. In this case, it is the `taskdef.yaml` file. And the "target" file, which uses `config.yaml` file content, can be configured as: @@ -50,11 +50,11 @@ containerDefinitions: ... ``` -In all cases, `Piped` will perform attaching the attachment file content at last, right before using it to handle any deployment tasks. +In all cases, `piped` will perform attaching the attachment file content at last, right before using it to handle any deployment tasks. ->**Tip:** +> **Tip:** > ->This feature can be used in combo with PipeCD [SecretManagement feature](../secret-management). You can encrypt your secret data using PipeCD secret encryption function, it will be decrypted and placed in your configuration files; then the PipeCD attachment feature will attach that decrypted configuration to the manifest of resource, which requires that configuration. +> This feature can be used in combo with PipeCD [Secret Management feature](../secret-management). You can encrypt your secret data using PipeCD secret encryption function, it will be decrypted and placed in your configuration files; then the PipeCD attachment feature will attach that decrypted configuration to the manifest of resource, which requires that configuration. diff --git a/docs/content/en/docs-v1.0.x/user-guide/managing-application/plan-preview.md b/docs/content/en/docs-v1.0.x/user-guide/managing-application/plan-preview.md index 3c370a8b7e..adb3f7769b 100644 --- a/docs/content/en/docs-v1.0.x/user-guide/managing-application/plan-preview.md +++ b/docs/content/en/docs-v1.0.x/user-guide/managing-application/plan-preview.md @@ -24,7 +24,7 @@ PlanPreview with GitHub actions The control plane ops can add a new project for a team. Project adding can be simply done from an internal web page prepared for the ops. -Because that web service is running in an `ops` pod, so in order to access it, using `kubectl port-forward` command to forward a local port to a port on the `ops` pod as following: +Because that web service is running in an `ops` pod, in order to access it, use the `kubectl port-forward` command to forward a local port to a port on the `ops` pod as following: ``` console kubectl port-forward service/pipecd-ops 9082 --namespace={NAMESPACE} @@ -21,4 +21,4 @@ Registering a new project requires only a unique ID string and an optional descr Once a new project has been registered, a static admin (username, password) will be automatically generated for the project admin. You can send that information to the project admin. The project admin first uses the provided static admin information to log in to PipeCD. After that, they can change the static admin information, configure the SSO, RBAC or disable static admin user. -__Caution:__ The Role-Based Access Control (RBAC) setting is required to enable your team login using SSO, please make sure you have that setup before disable static admin user. \ No newline at end of file +__Caution:__ The Role-Based Access Control (RBAC) setting is required to enable your team to log in using SSO. Please make sure you have that setup before disabling the static admin user. \ No newline at end of file diff --git a/docs/content/en/docs-v1.0.x/user-guide/managing-controlplane/architecture-overview.md b/docs/content/en/docs-v1.0.x/user-guide/managing-controlplane/architecture-overview.md index 4166700b69..cb786a657c 100644 --- a/docs/content/en/docs-v1.0.x/user-guide/managing-controlplane/architecture-overview.md +++ b/docs/content/en/docs-v1.0.x/user-guide/managing-controlplane/architecture-overview.md @@ -11,11 +11,11 @@ description: > Component Architecture

-The control plane is a centralized part of PipeCD. It contains several services as below to manage the application, deployment data and handle all requests from `piped`s and web clients: +The control plane is a centralized part of PipeCD. It contains several services as below to manage the application, deployment data and handle all requests from `piped` instances and web clients: ##### Server -`server` handles all incoming gRPC requests from `piped`s, web clients, incoming HTTP requests such as auth callback from third party services. +`server` handles all incoming gRPC requests from `piped` instances, web clients, incoming HTTP requests such as auth callback from third party services. It also serves all web assets including HTML, JS, CSS... This service can be easily scaled by updating the pod number. diff --git a/docs/content/en/docs-v1.0.x/user-guide/managing-controlplane/auth.md b/docs/content/en/docs-v1.0.x/user-guide/managing-controlplane/auth.md index d3d5a8a93b..1686afa1a7 100644 --- a/docs/content/en/docs-v1.0.x/user-guide/managing-controlplane/auth.md +++ b/docs/content/en/docs-v1.0.x/user-guide/managing-controlplane/auth.md @@ -3,7 +3,7 @@ title: "Authentication and authorization" linkTitle: "Authentication and authorization" weight: 3 description: > - This page describes about PipeCD Authentication and Authorization. + This page describes PipeCD Authentication and Authorization. --- ![Project Settings](/images/settings-project-v0.38.x.png) @@ -25,7 +25,7 @@ The project can be configured to use a shared SSO configuration (shared OAuth ap - GitHub - Generic OIDC -> Note: In the future, we want to support such as Google Gmail, Bitbucket... +> **Note:** In the future, we want to support such as Google Gmail, Bitbucket... #### Github @@ -45,7 +45,7 @@ Requirements and Troubleshooting: - The OIDC provider must provide claims for user's roles and username. - Roles claim value must use same values as pre-configured project RBAC Roles. -- - Claims can be retreived from the IdToken or UserInfo endpoint. The UserInfo endpoint will be used if issuer supports it. +- Claims can be retrieved from the IdToken or UserInfo endpoint. The UserInfo endpoint will be used if issuer supports it. - You can use set a custom claim key name for roles and username in the OIDC provider. Using `usernameClaimKey` and `rolesClaimKey` in the configuration. If not set, the default value will be chosen in the following order: - Supported Claims Key for Username (in order of priority): `username`, `preferred_username`,`name`, `cognito:username` @@ -254,8 +254,8 @@ resources=*;actions=* User Group represents a relation with a specific team (GitHub)/group (Google) and an arbitrary role. All users belong to a team/group will have all permissions of that team/group. -In case of using the GitHub team as a PipeCD user group, the PipeCD user group must be set in lowercase. For example, if your GitHub team is named `ORG/ABC-TEAM`, the PipeCD user group would be set as `ORG/abc-team`. (It's follow the GitHub team URL as github.com/orgs/{organization-name}/teams/{TEAM-NAME}) +In case of using the GitHub team as a PipeCD user group, the PipeCD user group must be set in lowercase. For example, if your GitHub team is named `ORG/ABC-TEAM`, the PipeCD user group would be set as `ORG/abc-team`. (It follows the GitHub team URL as github.com/orgs/{organization-name}/teams/{TEAM-NAME}) -Note: You CANNOT assign multiple roles to a team/group, should create a new role with suitable permissions instead. +> **Note:** You CANNOT assign multiple roles to a team/group. You should create a new role with suitable permissions instead. ![](/images/settings-add-user-group.png) diff --git a/docs/content/en/docs-v1.0.x/user-guide/managing-controlplane/registering-a-piped.md b/docs/content/en/docs-v1.0.x/user-guide/managing-controlplane/registering-a-piped.md index 9719f26f8d..a31df82105 100644 --- a/docs/content/en/docs-v1.0.x/user-guide/managing-controlplane/registering-a-piped.md +++ b/docs/content/en/docs-v1.0.x/user-guide/managing-controlplane/registering-a-piped.md @@ -6,7 +6,7 @@ description: > This page describes how to register a new piped to a project. --- -The list of pipeds are shown in the Settings page. Anyone who has the project admin role can register a new piped by clicking on the `+ADD` button. +The list of `piped` instances are shown in the Settings page. Anyone who has the project admin role can register a new `piped` by clicking on the `+ADD` button.
diff --git a/docs/content/en/docs-v1.0.x/user-guide/observability-and-metrics/_index.md b/docs/content/en/docs-v1.0.x/user-guide/observability-and-metrics/_index.md index 050cbac14f..aba122130e 100644 --- a/docs/content/en/docs-v1.0.x/user-guide/observability-and-metrics/_index.md +++ b/docs/content/en/docs-v1.0.x/user-guide/observability-and-metrics/_index.md @@ -6,4 +6,4 @@ description: > Understand how you can get end-to-end visibility of your PipeCD deployment through a collection of various metrics. --- -> Note: You must have at least one activated/running Piped to enable using any of the following features of PipeCD. Please refer to [Piped installation docs](../../installation/install-piped/) if you do not have any Piped in your pocket. +> **Note:** You must have at least one activated/running `piped` to enable using any of the following features of PipeCD. Please refer to [piped installation docs](../../installation/install-piped/) if you do not have any `piped` in your pocket. diff --git a/docs/content/en/docs-v1.0.x/user-guide/observability-and-metrics/metrics.md b/docs/content/en/docs-v1.0.x/user-guide/observability-and-metrics/metrics.md index dfb9c02bbe..f48cc8a674 100644 --- a/docs/content/en/docs-v1.0.x/user-guide/observability-and-metrics/metrics.md +++ b/docs/content/en/docs-v1.0.x/user-guide/observability-and-metrics/metrics.md @@ -3,7 +3,7 @@ title: "Metrics" linkTitle: "Metrics" weight: 995 description: > - This page describes how to enable monitoring system for collecting PipeCD' metrics. + This page describes how to enable monitoring system for collecting PipeCD's metrics. --- PipeCD comes with a monitoring system including Prometheus, Alertmanager, and Grafana. @@ -23,7 +23,7 @@ The piped agent collects its metrics and periodically sends them to the Control Developers managing the piped agent can also get metrics directly from the piped agent and monitor them with their custom monitoring service. ## Enable monitoring system -To enable monitoring system for PipeCD, you first need to set the following value to `helm install` when [installing](../../../installation/install-controlplane/#2-preparing-control-plane-configuration-file-and-installing). +To enable monitoring system for PipeCD, you first need to set the following value to `helm install` when [installing](../../../installation/install-control-plane/#2-preparing-control-plane-configuration-file-and-installing). ``` --set monitoring.enabled=true @@ -43,8 +43,8 @@ There are three dashboards related to Control Plane: - Incoming Requests - gRPC and HTTP requests stats to check for any negative impact on users - Go - processes stats of PipeCD components -#### Piped dashboards -Visualize the metrics of Piped registered in the Control plane. +#### `piped` dashboards +Visualize the metrics of `piped` registered in the Control plane. - Overview - usage stats of piped agents - Process - resource usage of piped agent - Go - processes stats of piped agents. @@ -80,7 +80,7 @@ prometheus: - channel: '#your-channel' ``` -And give it to the `helm install` command when [installing](../../../installation/install-controlplane/#2-preparing-control-plane-configuration-file-and-installing). +And give it to the `helm install` command when [installing](../../../installation/install-control-plane/#2-preparing-control-plane-configuration-file-and-installing). ``` --values=values.yaml @@ -88,7 +88,7 @@ And give it to the `helm install` command when [installing](../../../installatio See [here](https://prometheus.io/docs/alerting/latest/configuration/) for more details on AlertManager's configuration. -## Piped agent metrics +## `piped` agent metrics | Metric | Type | Description | | --- | --- | --- | @@ -102,7 +102,7 @@ See [here](https://prometheus.io/docs/alerting/latest/configuration/) for more d ## Control plane metrics -All Piped's metrics are sent to the control plane so that they are also available on the control plane's metrics server. +All `piped`'s metrics are sent to the control plane so that they are also available on the control plane's metrics server. | Metric | Type | Description | | --- | --- | --- | diff --git a/docs/content/en/docs-v1.0.x/user-guide/terraform-provider-pipecd.md b/docs/content/en/docs-v1.0.x/user-guide/terraform-provider-pipecd.md index 5e62f0154b..cecf4947c2 100644 --- a/docs/content/en/docs-v1.0.x/user-guide/terraform-provider-pipecd.md +++ b/docs/content/en/docs-v1.0.x/user-guide/terraform-provider-pipecd.md @@ -12,7 +12,7 @@ This provider enables us to add, update, and delete PipeCD resources as Infrast ## Usage ### Setup Terraform provider -Add terraform block to declare that you use PipeCD Terraform provider. You need to input a controle plane's host name and API key via provider settings or environment variables. API key is available on the web UI. +Add terraform block to declare that you use PipeCD Terraform provider. You need to input a control plane's host name and API key via provider settings or environment variables. API key is available on the web UI. ```hcl terraform { @@ -31,8 +31,8 @@ provider "pipecd" { } ``` -### Manage Piped agent -Add `pipecd_piped` resource to manage a Piped agent. +### Manage `piped` agent +Add `pipecd_piped` resource to manage a `piped` agent. ```hcl resource "pipecd_piped" "mypiped" { From 256b51969f92ce106cecbd8f3fdb7c6a6ac1ea63 Mon Sep 17 00:00:00 2001 From: rahulshendre Date: Tue, 27 Jan 2026 18:02:11 +0530 Subject: [PATCH 2/2] wording change Signed-off-by: rahulshendre --- .../install-control-plane/installing-controlplane-on-ECS.md | 2 +- .../user-guide/managing-controlplane/adding-a-project.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/content/en/docs-v1.0.x/installation/install-control-plane/installing-controlplane-on-ECS.md b/docs/content/en/docs-v1.0.x/installation/install-control-plane/installing-controlplane-on-ECS.md index 6c499b9910..f1a9ff805d 100644 --- a/docs/content/en/docs-v1.0.x/installation/install-control-plane/installing-controlplane-on-ECS.md +++ b/docs/content/en/docs-v1.0.x/installation/install-control-plane/installing-controlplane-on-ECS.md @@ -8,5 +8,5 @@ description: > Currently, we provide an example of deploying Control Plane to ECS using Terraform. -Please refer to the blog post :) +Please refer to the blog post: [PipeCD best practice 02 - control plane on ECS]({{< ref "/blog/control-plane-on-ecs.md" >}} "PipeCD best practice 02 - control plane on ECS"). diff --git a/docs/content/en/docs-v1.0.x/user-guide/managing-controlplane/adding-a-project.md b/docs/content/en/docs-v1.0.x/user-guide/managing-controlplane/adding-a-project.md index 93b8f513cd..76d5d19d73 100644 --- a/docs/content/en/docs-v1.0.x/user-guide/managing-controlplane/adding-a-project.md +++ b/docs/content/en/docs-v1.0.x/user-guide/managing-controlplane/adding-a-project.md @@ -21,4 +21,4 @@ Registering a new project requires only a unique ID string and an optional descr Once a new project has been registered, a static admin (username, password) will be automatically generated for the project admin. You can send that information to the project admin. The project admin first uses the provided static admin information to log in to PipeCD. After that, they can change the static admin information, configure the SSO, RBAC or disable static admin user. -__Caution:__ The Role-Based Access Control (RBAC) setting is required to enable your team to log in using SSO. Please make sure you have that setup before disabling the static admin user. \ No newline at end of file +> **Important:** Configure RBAC before disabling the static admin user. RBAC is required for SSO login. \ No newline at end of file