Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
Release v0.40.0 (#4023)
* Release v0.40.0

* Update readme

* Update release note

* Add docs for v0.40.x
  • Loading branch information
khanhtc1202 committed Nov 30, 2022
1 parent 9d1ddf4 commit 4d616f6
Show file tree
Hide file tree
Showing 75 changed files with 6,226 additions and 2 deletions.
2 changes: 1 addition & 1 deletion RELEASE
@@ -1,4 +1,4 @@
tag: v0.39.0
tag: v0.40.0

releaseNoteGenerator:
showCommitter: false
Expand Down
4 changes: 4 additions & 0 deletions docs/config.toml
Expand Up @@ -163,6 +163,10 @@ no = 'Sorry to hear that. Please <a href="https://github.com/pipe-cd/pipecd/issu
githubbranch = "master"
url = "/docs-dev/"

[[params.versions]]
version = "v0.40.x"
url = "/docs-v0.40.x/"

[[params.versions]]
version = "v0.39.x"
url = "/docs-v0.39.x/"
Expand Down
65 changes: 65 additions & 0 deletions docs/content/en/blog/releases/v0.40.0.md
@@ -0,0 +1,65 @@
---
title: "Release v0.40.0"
linkTitle: "Release v0.40.0"
date: 2022-11-30
description: >
Release v0.40.0
---

## Changes since v0.39.0
### Notable Changes

* Enable to restart Piped from the PipeCD console [#3988](https://github.com/pipe-cd/pipecd/pull/3988)
* Allow config MySQL database via config URL ([#4017](https://github.com/pipe-cd/pipecd/pull/4017))
* Fix K8s resources are not pruned even if running Quick Sync ([#3991](https://github.com/pipe-cd/pipecd/pull/3991))

### Internal Changes

* Release v0.40.0
* Update web dependencies ([#4031](https://github.com/pipe-cd/pipecd/pull/4031))
* Fix the invalid link ([#4027](https://github.com/pipe-cd/pipecd/pull/4027))
* Bump glob-parent from 5.1.1 to 5.1.2 in /web ([#4030](https://github.com/pipe-cd/pipecd/pull/4030))
* Bump follow-redirects from 1.11.0 to 1.15.2 in /web ([#4028](https://github.com/pipe-cd/pipecd/pull/4028))
* Bump nanoid from 3.1.29 to 3.3.4 in /docs ([#4029](https://github.com/pipe-cd/pipecd/pull/4029))
* Bump node-fetch from 2.6.1 to 2.6.7 in /web ([#3380](https://github.com/pipe-cd/pipecd/pull/3380))
* Bump ansi-regex from 5.0.0 to 5.0.1 in /web ([#4026](https://github.com/pipe-cd/pipecd/pull/4026))
* Bump terser from 5.6.1 to 5.16.0 in /web ([#4025](https://github.com/pipe-cd/pipecd/pull/4025))
* Update examples readme ([#4022](https://github.com/pipe-cd/pipecd/pull/4022))
* Update web dependencies ([#4021](https://github.com/pipe-cd/pipecd/pull/4021))
* Add readme to manifests directory ([#4020](https://github.com/pipe-cd/pipecd/pull/4020))
* Add docs for upgrading control plane ([#4019](https://github.com/pipe-cd/pipecd/pull/4019))
* Sync docs ([#4018](https://github.com/pipe-cd/pipecd/pull/4018))
* Add frontend implementation for Insights feature ([#4010](https://github.com/pipe-cd/pipecd/pull/4010))
* Bump path-parse from 1.0.6 to 1.0.7 in /web ([#4013](https://github.com/pipe-cd/pipecd/pull/4013))
* Bump ajv from 6.12.2 to 6.12.6 in /web ([#4016](https://github.com/pipe-cd/pipecd/pull/4016))
* Bump ws from 6.2.1 to 6.2.2 in /web ([#4015](https://github.com/pipe-cd/pipecd/pull/4015))
* Bump browserslist from 4.14.7 to 4.21.4 in /web ([#4014](https://github.com/pipe-cd/pipecd/pull/4014))
* Bump dns-packet from 1.3.1 to 1.3.4 in /web ([#4012](https://github.com/pipe-cd/pipecd/pull/4012))
* Bump tmpl from 1.0.4 to 1.0.5 in /web ([#4011](https://github.com/pipe-cd/pipecd/pull/4011))
* Bump websocket-extensions from 0.1.3 to 0.1.4 in /web ([#4009](https://github.com/pipe-cd/pipecd/pull/4009))
* Bump y18n from 4.0.0 to 4.0.3 in /web ([#4008](https://github.com/pipe-cd/pipecd/pull/4008))
* Make it possible to use labels to filter insight data ([#4007](https://github.com/pipe-cd/pipecd/pull/4007))
* Fix to escape the user-provided value for ops ([#4006](https://github.com/pipe-cd/pipecd/pull/4006))
* Update web dependencies ([#4005](https://github.com/pipe-cd/pipecd/pull/4005))
* Migrate from legacy loaders to asset module ([#4004](https://github.com/pipe-cd/pipecd/pull/4004))
* Make it possible to specify InsightStep in GetInsightData RPC ([#4003](https://github.com/pipe-cd/pipecd/pull/4003))
* Add GetInsightData RPC under a feature flag ([#4002](https://github.com/pipe-cd/pipecd/pull/4002))
* Add web components for Insights feature ([#4000](https://github.com/pipe-cd/pipecd/pull/4000))
* Add fix lint web command ([#4001](https://github.com/pipe-cd/pipecd/pull/4001))
* Add missing json tags for application data ([#3999](https://github.com/pipe-cd/pipecd/pull/3999))
* Add missing indexes for insights and minor fixes ([#3998](https://github.com/pipe-cd/pipecd/pull/3998))
* Add backend implementation for Insights feature ([#3993](https://github.com/pipe-cd/pipecd/pull/3993))
* Update Go version to v1.19 ([#3997](https://github.com/pipe-cd/pipecd/pull/3997))
* Fix the wrong link for registering a piped docs ([#3996](https://github.com/pipe-cd/pipecd/pull/3996))
* Add code of conduct ([#3994](https://github.com/pipe-cd/pipecd/pull/3994))
* Add maintainers list ([#3992](https://github.com/pipe-cd/pipecd/pull/3992))
* Add restart piped UI ([#3990](https://github.com/pipe-cd/pipecd/pull/3990))
* Fix the invalid link ([#3989](https://github.com/pipe-cd/pipecd/pull/3989))
* Bump minimatch from 3.0.4 to 3.1.2 in /web ([#3987](https://github.com/pipe-cd/pipecd/pull/3987))
* Bump loader-utils from 1.4.1 to 1.4.2 in /web ([#3986](https://github.com/pipe-cd/pipecd/pull/3986))
* Fix to use the relative path for the docs ([#3985](https://github.com/pipe-cd/pipecd/pull/3985))
* Update quickstart docs ([#3983](https://github.com/pipe-cd/pipecd/pull/3983))
* Fix all links for dev docs ([#3984](https://github.com/pipe-cd/pipecd/pull/3984))
* Remove the old docs ([#3982](https://github.com/pipe-cd/pipecd/pull/3982))
* Update release v0.39.0 blog ([#3979](https://github.com/pipe-cd/pipecd/pull/3979))
* Bump loader-utils from 1.4.0 to 1.4.1 in /web ([#3981](https://github.com/pipe-cd/pipecd/pull/3981))
5 changes: 5 additions & 0 deletions docs/content/en/docs-v0.40.x/_index.md
@@ -0,0 +1,5 @@
---
title: "Welcome to PipeCD"
linkTitle: "Documentation [v0.40.x]"
type: docs
---
75 changes: 75 additions & 0 deletions docs/content/en/docs-v0.40.x/concepts/_index.md
@@ -0,0 +1,75 @@
---
title: "Concepts"
linkTitle: "Concepts"
weight: 2
description: >
This page describes several core concepts in PipeCD.
---

![](/images/architecture-overview.png)
<p style="text-align: center;">
Component Architecture
</p>

### Piped

`piped` is a single binary component you run as an agent in your cluster, your local network to handle the deployment tasks.
It can be run inside a Kubernetes cluster by simply starting a Pod or a Deployment.
This component is designed to be stateless, so it can also be run in a single VM or even your local machine.

### Control Plane

A centralized component managing deployment data and provides gPRC API for connecting `piped`s as well as all web-functionalities of PipeCD such as
authentication, showing deployment list/details, application list/details, delivery insights...

### Project

A project is a logical group of applications to be managed by a group of users.
Each project can have multiple `piped` instances from different clouds or environments.

There are three types of project roles:

- **Viewer** has only permissions of viewing to deployment and application in the project.
- **Editor** has all viewer permissions, plus permissions for actions that modify state such as manually trigger/cancel the deployment.
- **Admin** has all editor permissions, plus permissions for managing project data, managing project `piped`.

### Application

A collect of resources (containers, services, infrastructure components...) and configurations that are managed together.
PipeCD supports multiple kinds of applications such as `KUBERNETES`, `TERRAFORM`, `ECS`, `CLOUDRUN`, `LAMBDA`...

### Application Configuration

A YAML file that contains information to define and configure application.
Each application requires one file at application directory stored in the Git repository.
The default file name is `app.pipecd.yaml`.

### Application Directory

A directory in Git repository containing application configuration file and application manifests.
Each application must have one application directory.

### Deployment

A deployment is a process that does transition from the current state (running state) to the desired state (specified state in Git) of a specific application.
When the deployment is success, it means the running state is being synced with the desired state specified in the target commit.

### Sync Strategy

There are 3 strategies that PipeCD supports while syncing your application state with its configuration stored in Git. Which are:
- Quick Sync: a fast way to make the running application state as same as its Git stored configuration. The generated pipeline contains only one predefined `SYNC` stage.
- Pipeline Sync: sync the running application state with its Git stored configuration through a pipeline defined in its application configuration.
- Auto Sync: depends on your defined application configuration, `piped` will decide the best way to sync your application state with its Git stored configuration.

### Platform Provider

Note: The previous name of this concept was Cloud Provider.

PipeCD supports multiple platforms and multiple kinds of applications.
Platform Provider defines which platform, cloud and where application should be deployed to.

Currently, PipeCD is supporting these five platform providers: `KUBERNETES`, `ECS`, `TERRAFORM`, `CLOUDRUN`, `LAMBDA`.

### Analysis Provider
An external product that provides metrics/logs to evaluate deployments, such as `Prometheus`, `Datadog`, `Stackdriver`, `CloudWatch` and so on.
It is mainly used in the [Automated deployment analysis](../user-guide/managing-application/customizing-deployment/automated-deployment-analysis/) context.
@@ -0,0 +1,7 @@
---
title: "Contributor Guide"
linkTitle: "Contributor Guide"
weight: 6
description: >
This guide is for anyone who want to contribute to PipeCD project. We are so excited to have you!
---
@@ -0,0 +1,36 @@
---
title: "Architectural overview"
linkTitle: "Architectural overview"
weight: 3
description: >
This page describes the architecture of PipeCD.
---

![](/images/architecture-overview.png)
<p style="text-align: center;">
Component Architecture
</p>

### Piped

A single binary component runs in your cluster, your local network to handle the deployment tasks.
It can be run inside a Kubernetes cluster by simply starting a Pod or a Deployment.
This component is designed to be stateless, so it can also be run in a single VM or even your local machine.

### Control Plane

A centralized component manages deployment data and provides gPRC API for connecting `piped`s as well as all web-functionalities of PipeCD such as
authentication, showing deployment list/details, application list/details, delivery insights...

Control Plane contains the following components:
- `server`: a service to provide api for piped, web and serve static assets for web.
- `ops`: a service to provide administrative features for Control Plane owner like adding/managing projects.
- `cache`: a redis cache service for caching internal data.
- `datastore`: data storage for storing deployment, application data
- this can be a fully-managed service such as `Firestore`, `Cloud SQL`...
- or a self-managed such as `MySQL`
- `filestore`: file storage for storing logs, application states
- this can a fully-managed service such as `GCS`, `S3`...
- or a self-managed service such as `Minio`

For more information, see [Architecture overview of Control Plane](../../user-guide/managing-controlplane/architecture-overview/).
@@ -0,0 +1,33 @@
---
title: "Contributing"
linkTitle: "Contributing"
weight: 1
description: >
This page describes how to contribute to PipeCD.
---

PipeCD is an open source project that anyone in the community can use, improve, and enjoy. We'd love you to join us!

## Contributor License Agreement

Contributions to this project must be accompanied by a Contributor License Agreement ("CLA") described at [pipe-cd/pipecd/master/CLA.md](https://github.com/pipe-cd/pipecd/blob/master/CLA.md). You (or your employer) retain the copyright to your contribution; this simply gives us permission to use and redistribute your contributions as part of the project.

You generally only need to sign a CLA once, so if you've already signed one, you probably don't need to do it again.

In case you have not signed yet, [pipecd-bot](https://github.com/pipecd-bot) will guide you to sign the CLA _when you send the first pull request to [pipe-cd/pipecd](https://github.com/pipe-cd/pipecd) repository_.

## Creating an issue

If you've found a problem, please create an issue in the [pipe-cd/pipecd](https://github.com/pipe-cd/pipecd/issues) repository.

## Creating a pull request

Look at our [help wanted issues](https://github.com/pipe-cd/pipecd/issues?q=is%3Aissue+is%3Aopen+label%3A"help+wanted") or our [good first issues](https://github.com/pipe-cd/pipecd/issues?q=is%3Aissue+is%3Aopen+label%3A"good+first+issue") for finding some good issues for your first pull request.

### Small tips

The pull request title is used to generate our release changelog. Therefore, it would be great if you write the title that is easier to understand from the user's point of view.

## Code reviews

All submissions, including submissions by project members, require review. We use GitHub pull requests for this purpose. Consult [GitHub Help](https://help.github.com/en/github/collaborating-with-issues-and-pull-requests/about-pull-requests) for more information on using pull requests.
@@ -0,0 +1,93 @@
---
title: "Development"
linkTitle: "Development"
weight: 2
description: >
This page describes how to build, test PipeCD source code at your local environment.
---

## Prerequisites

- [Go 1.19](https://go.dev/)
- [Docker Decktop](https://www.docker.com/products/docker-desktop/)
- [kind](https://kind.sigs.k8s.io/docs/user/quick-start/#installation) (If you want to run Control Plane locally)

## Repositories
- [pipecd](https://github.com/pipe-cd/pipecd): contains all source code and documentation of PipeCD project.
- [examples](https://github.com/pipe-cd/examples): contains various generated examples to demonstrate how to use PipeCD.

## Commands

- `make build/go`: builds all go modules including pipecd, piped, pipectl.
- `make build/web`: builds the static files for web.

- `make test/go`: runs all unit tests of go modules.
- `make test/web`: runs all unit tests of web.
- `make test/integration`: runs integration tests.

- `make run/piped`: runs Piped locally (for more information, see [here](#how-to-run-piped-agent-locally)).
- `make run/site`: runs PipeCD site locally (requires [hugo](https://github.com/gohugoio/hugo) with `_extended` version `0.92.1` or later to be installed).

- `make gen/code`: generate Go and Typescript code from protos and mock configs. You need to run it if you modified any proto or mock definition files.

For the full list of available commands, please see the Makefile at the root of repository.

## How to run Control Plane locally

1. Start running a Kubernetes cluster

``` console
make kind-up
```

Once it is no longer used, run `make kind-down` to delete it.

2. Install Control Plane into the local cluster

``` console
make run/pipecd
```

Once all components are running up, use `kubectl port-forward` to expose the installed Control Plane on your localhost:

``` console
kubectl -n pipecd port-forward svc/pipecd 8080
```

3. Access to the local Control Plane web console

Point your web browser to [http://localhost:8080](http://localhost:8080) to login with the configured static admin account: project = `quickstart`, username = `hello-pipecd`, password = `hello-pipecd`.

## How to run Piped agent locally

1. Prepare the piped configuration file `piped-config.yaml`

2. Ensure that your `kube-context` is connecting to the right kubernetes cluster

3. Run the following command to start running `piped` (if you want to connect Piped to a locally running Control Plane, add `INSECURE=true` option)

``` console
make run/piped CONFIG_FILE=piped-config.yaml
```

## Docs and workaround with docs

PipeCD official site contains multiple versions of documentation, all placed under the `/docs/content/en` directory, which are:
- `/docs`: stable version docs, usually synced with the latest released version docs.
- `/docs-dev`: experimental version docs, contains docs for not yet released features or changes.
- `/docs-v0.x.x`: contains docs for specified version family (a version family is all versions which in the same major release).

Basically, we have two simple rules:
- Do not touch to the `/docs` content directly.
- Keep stable docs version synced with the latest released docs version.

Here are the flow of docs contribution regard some known scenarios:
1. Update docs that are related to a specified version (which is not the latest released version):
In such case, update the docs under `/docs-v0.x.x` is enough.
2. Update docs for not yet released features or changes:
In such case, update the docs under `/docs-dev` is enough.
3. Update docs that are related to the latest released docs version:
- Change the docs' content that fixes the issue under `/docs-dev` and `/docs-v0.x.x`, they share the same file structure so you should find the right files in both directories.
- Use `make gen/stable-docs` command to sync the latest released version docs under `/docs-v0.x.x` to `/docs`

If you find any issues related to the docs, we're happy to accept your help.

0 comments on commit 4d616f6

Please sign in to comment.