Skip to content

Conversation

@eeshaanSA
Copy link
Contributor

What this PR does:

Fix controlplane docs

Why we need it:

Which issue(s) this PR fixes:

Fixes #

Does this PR introduce a user-facing change?:

  • How are users affected by this change:
  • Is this breaking change:
  • How to migrate (if breaking change):

Signed-off-by: Eeshaan Sawant <eeshaans1@gmail.com>
@eeshaanSA eeshaanSA requested a review from a team as a code owner November 2, 2025 11:57
- **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 agent that connects your infrastructure to the Control Plane. In PipeCD v1, Piped drops built-in platform support and uses a plugin-based model. Each plugin (an external component) implements the deployment and synchronization logic for a specific application kind, such as Kubernetes or Terraform.
- **Piped** is a lightweight agent that connects your infrastructure to the Control Plane. In PipeCD v1, each plugin (an external component) implements the deployment and synchronization logic for a specific application kind, such as Kubernetes or Terraform.
Copy link
Member

@khanhtc1202 khanhtc1202 Nov 4, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We don't need to specify plugins here; no need to show too much information at once. Keep the quickstart as quickstart is better. Also, should not mention PipeCD v1 as discussed in this comment #6321 (comment)

Copy link
Member

@khanhtc1202 khanhtc1202 Nov 4, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think it's good to keep this same as quickstart for v0

PipeCD is constructed by two components: the Control plane and the piped (agent) (ref: PipeCD concepts). The control plane can be thought of as a regular web service application that can be installed anywhere, while the piped agent is a single binary that can run as a pod in a Kubernetes cluster, a container on ECS, a serverless function like Lambda, Cloud Run, or a process running directly on your local machine.

simply talk about pipecd controlplane and the piped, that can be installed anywhere

Copy link
Member

@khanhtc1202 khanhtc1202 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@eeshaanSA, I have only a small concern about the quickstart header. Anything else lgtm 👍

Signed-off-by: Eeshaan Sawant <eeshaans1@gmail.com>
@eeshaanSA
Copy link
Contributor Author

@khanhtc1202 please check now! Thanks

Copy link
Member

@khanhtc1202 khanhtc1202 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@khanhtc1202 khanhtc1202 merged commit 117ecb2 into pipe-cd:master Nov 12, 2025
43 checks passed
eeshaanSA added a commit to eeshaanSA/pipecd that referenced this pull request Nov 12, 2025
* Fix/Docs Quickstart/add controlplane screenshot

Signed-off-by: Eeshaan Sawant <eeshaans1@gmail.com>

* grammar changes

Signed-off-by: Eeshaan Sawant <eeshaans1@gmail.com>

---------

Signed-off-by: Eeshaan Sawant <eeshaans1@gmail.com>
Co-authored-by: Khanh Tran <32532742+khanhtc1202@users.noreply.github.com>
@github-actions github-actions bot mentioned this pull request Dec 23, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants