Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
53 changes: 27 additions & 26 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ We have a `#pipecd` channel on [CNCF Slack](https://cloud-native.slack.com/) for

### Join our public community meeting

We host the [PipeCD Development and Community Meetings](https://zoom-lfx.platform.linuxfoundation.org/meeting/96831504919?password=2f60b8ec-5896-40c8-aa1d-d551ab339d00) every 2 weeks, where we share the latest project news, demos, answer questions, and help triage issues. You can also view the [Meeting Notes and Agenda](https://bit.ly/pipecd-mtg-notes).
We host the PipeCD Community Meeting every 2 weeks. Please check the [#pipecd channel on CNCF Slack](https://cloud-native.slack.com/archives/C01B27F9T0X) for the latest schedule and meeting links. We share the latest project news, demos, answer questions, and help triage issues. You can also view the [Meeting Notes and Agenda](https://bit.ly/pipecd-mtg-notes).

### Join our team on GitHub

Expand Down Expand Up @@ -161,6 +161,7 @@ If your change introduces a user-facing change, please update the following sect

```md
**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)**:
Expand Down Expand Up @@ -193,7 +194,7 @@ Run `make update/go-deps` and `make update/web-deps` to update the dependencies.

In order to start a local development environment, a registry needs to be running locally.

Run `make up/local-cluster` to start a local registry.
Run `make up/local-cluster` to start a local registry.

This will create the kubernetes namespace `pipecd` if it does not exist and start a local registry in the namespace which can then be accessed by other components.

Expand Down Expand Up @@ -224,38 +225,38 @@ To login, you can use the configured static admin account as below:

2. Access to Control Plane console, go to Piped list page - click the three vertical dots on the top right corner and then click on settings. After clicking on settings you will land on the Piped settings page. Next, add a new piped.

Alternatively, you can go to `http://localhost:8080/settings/piped?project=quickstart`, please adjust the port and the project in the url if they are different from default.
Alternatively, you can go to `http://localhost:8080/settings/piped?project=quickstart`, please adjust the port and the project in the url if they are different from default.

Then, copy generated Piped ID and base64 key for `piped-config.yaml`

3. Create the piped configuration file `piped-config.yaml`, ideally in the root of the repository.

>**NOTE**
>If you want to work on multiple piped configuration files, it is recommended to create a .dev folder in the root of the repository and save them there. The .dev folder is configured in .gitignore, and thus, would not include your piped files in your commits.
> **NOTE**
> If you want to work on multiple piped configuration files, it is recommended to create a .dev folder in the root of the repository and save them there. The .dev folder is configured in .gitignore, and thus, would not include your piped files in your commits.

Below is an exampled piped v0 configuration using the Kubernetes platform provider. Use the PipeD ID and base64 key you created in step 2 here.

```yaml
apiVersion: pipecd.dev/v1beta1
kind: Piped
spec:
projectID: quickstart
pipedID: <YOUR PIPED ID> # Base64 encoded string of the piped private key.
pipedKeyData: <YOUR PIPED BASE64 KEY> # FIXME: Replace here with your piped base64 key.
apiAddress: localhost:8080 # Write in a format "localhost:port"
#Replace with your piped address if you connect Piped to a control plane that does not run locally, or runs on a different port.
repositories:
- repoId: example
remote: git@github.com:pipe-cd/examples.git
branch: master
syncInterval: 1m
platformProviders:
- name: example-kubernetes
type: KUBERNETES
config:
# FIXME: Replace here with your kubeconfig absolute file path.
kubeConfigPath: /path/to/.kube/config
```
```yaml
apiVersion: pipecd.dev/v1beta1
kind: Piped
spec:
projectID: quickstart
pipedID: <YOUR PIPED ID> # Base64 encoded string of the piped private key.
pipedKeyData: <YOUR PIPED BASE64 KEY> # FIXME: Replace here with your piped base64 key.
apiAddress: localhost:8080 # Write in a format "localhost:port"
#Replace with your piped address if you connect Piped to a control plane that does not run locally, or runs on a different port.
repositories:
- repoId: example
remote: git@github.com:pipe-cd/examples.git
branch: master
syncInterval: 1m
platformProviders:
- name: example-kubernetes
type: KUBERNETES
config:
# FIXME: Replace here with your kubeconfig absolute file path.
kubeConfigPath: /path/to/.kube/config
```

4. Once you have configured your piped configuration file, start the Piped agent with the following command:

Expand Down
Loading