Release version v0.41.0 (#4090)

* Release version v0.41.0

* Update release note

* Change order

* Add new features note

* Update note

* Update note

Author: khanhtc1202

RELEASE

@@ -1,4 +1,4 @@
-tag: v0.40.1
+tag: v0.41.0
 
 releaseNoteGenerator:
   showCommitter: false

docs/config.toml

@@ -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.41.x"
+  url = "/docs-v0.41.x/"
+
 [[params.versions]]
   version = "v0.40.x"
   url = "/docs-v0.40.x/"

docs/content/en/blog/releases/v0.41.0.md

@@ -0,0 +1,91 @@
+---
+title: "Release v0.41.0"
+linkTitle: "Release v0.41.0"
+date: 2022-12-20
+description: >
+ Release v0.41.0
+---
+
+## Changes since v0.40.1
+
+### Breaking Changes
+
+All __applications configuration__ file should NOT use the `spec.triggerPaths` (marked as deprecated previously), but use `spec.trigger.onCommit.paths` instead. Refer to [application configuration docs](/docs/user-guide/configuration-reference/#deploymenttrigger)
+
+```yaml
+apiVersion: pipecd.dev/v1beta1
+kind: KubernetesApp
+spec:
+  name: analysis-by-http
+  labels:
+    env: example
+    team: product
+  # Previously, this will NOT be accepted for new version.
+  triggerPaths:
+    - deployment.yaml
+  # Use this pattern instead.
+  trigger:
+    onCommit:
+      paths:
+        - deployment.yaml
+```
+
+* Remove trigger paths ([#4037](https://github.com/pipe-cd/pipecd/pull/4037))
+
+### New features
+
+From now, you can have a better insight into your application/project's deployment via deployment data visualized by the PipeCD insight feature. Please refer to the [docs](/docs/user-guide/insights/).
+
+![image](/images/insights.png)
+
+* Introduce Insights feature ([#4071](https://github.com/pipe-cd/pipecd/pull/4071))
+* Support Cloud Run application for planpreview ([#4079](https://github.com/pipe-cd/pipecd/pull/4079))
+* Support setting kubectlVersion via piped config ([#4081](https://github.com/pipe-cd/pipecd/pull/4081))
+* Add `spec.trigger.onCommit.ignores` to application config ([#4059](https://github.com/pipe-cd/pipecd/pull/4059))
+
+### Notable Changes
+
+* Improve the health description for Cloud Run live state ([#4085](https://github.com/pipe-cd/pipecd/pull/4085))
+* Add `--include-crds` option to include CRDS for Helm ([#4077](https://github.com/pipe-cd/pipecd/pull/4077))
+* Ensure newly created revision is ready to receive traffic before going to the next stage ([#4074](https://github.com/pipe-cd/pipecd/pull/4074))
+* Update web dependencies ([#4061](https://github.com/pipe-cd/pipecd/pull/4061))
+* Use helper "serviceAccountName" on create role binding ([#4054](https://github.com/pipe-cd/pipecd/pull/4054))
+
+### Internal Changes
+
+* Refactor the loadCloudRunManifest function ([#4089](https://github.com/pipe-cd/pipecd/pull/4089))
+* Enable to run lint/go on M1 ([#4088](https://github.com/pipe-cd/pipecd/pull/4088))
+* Implement lint/go command for local ([#4086](https://github.com/pipe-cd/pipecd/pull/4086))
+* Fix the wrong link for tools ([#4083](https://github.com/pipe-cd/pipecd/pull/4083))
+* Remove unused docs ([#4082](https://github.com/pipe-cd/pipecd/pull/4082))
+* Rename symbol cloudProvider to platformProvider ([#4080](https://github.com/pipe-cd/pipecd/pull/4080))
+* Rename Insighs step to resolution ([#4078](https://github.com/pipe-cd/pipecd/pull/4078))
+* Fix application store listBy method ([#4075](https://github.com/pipe-cd/pipecd/pull/4075))
+* Fix app live resource lister wrong attribute ([#4072](https://github.com/pipe-cd/pipecd/pull/4072))
+* Update pull request template ([#4073](https://github.com/pipe-cd/pipecd/pull/4073))
+* Update insights doc ([#4070](https://github.com/pipe-cd/pipecd/pull/4070))
+* Add the log for detecting pruned manifest ([#4068](https://github.com/pipe-cd/pipecd/pull/4068))
+* Better time range based on step to request Insights data ([#4069](https://github.com/pipe-cd/pipecd/pull/4069))
+* Update the codeql actoins to v2 ([#4067](https://github.com/pipe-cd/pipecd/pull/4067))
+* Make it possible to run the codeql workflow manually ([#4066](https://github.com/pipe-cd/pipecd/pull/4066))
+* Update the codeql analysis schedule ([#4065](https://github.com/pipe-cd/pipecd/pull/4065))
+* fix description of apiAddress ([#4064](https://github.com/pipe-cd/pipecd/pull/4064))
+* Enable deployment frequency and failure rate charts ([#4062](https://github.com/pipe-cd/pipecd/pull/4062))
+* Update docs for onCommit.ignores ([#4063](https://github.com/pipe-cd/pipecd/pull/4063))
+* Fix bug on parsing empty kubernetes manifest ([#4060](https://github.com/pipe-cd/pipecd/pull/4060))
+* Apply cache to store completed Insight chunk ([#4057](https://github.com/pipe-cd/pipecd/pull/4057))
+* Update the default resources docs ([#4058](https://github.com/pipe-cd/pipecd/pull/4058))
+* Add release command ([#4056](https://github.com/pipe-cd/pipecd/pull/4056))
+* Update gen release docs command ([#4055](https://github.com/pipe-cd/pipecd/pull/4055))
+* Ensure group version docs ([#4053](https://github.com/pipe-cd/pipecd/pull/4053))
+* Update actions-gh-release version to v2.4.0 ([#4052](https://github.com/pipe-cd/pipecd/pull/4052))
+* Fix the wrong link for actions-gh-release ([#4051](https://github.com/pipe-cd/pipecd/pull/4051))
+* Replace all of pull request numbers with their link because of release note ([#4050](https://github.com/pipe-cd/pipecd/pull/4050))
+* Add release commands to make ([#4049](https://github.com/pipe-cd/pipecd/pull/4049))
+* Remove unused config ([#4045](https://github.com/pipe-cd/pipecd/pull/4045))
+* Use a make command instead of a hack command directly ([#4046](https://github.com/pipe-cd/pipecd/pull/4046))
+* Bump decode-uri-component from 0.2.0 to 0.2.2 in /web ([#4048](https://github.com/pipe-cd/pipecd/pull/4048))
+* Replace deprecated actions commands with env files ([#4047](https://github.com/pipe-cd/pipecd/pull/4047))
+* Remove unused docs ([#4044](https://github.com/pipe-cd/pipecd/pull/4044))
+* Add helm 3.8.2 to PipeCD prerequisites ([#4043](https://github.com/pipe-cd/pipecd/pull/4043))
+* Fix the release note ([#4042](https://github.com/pipe-cd/pipecd/pull/4042))

docs/content/en/docs-v0.41.x/_index.md

@@ -0,0 +1,5 @@
+---
+title: "Welcome to PipeCD"
+linkTitle: "Documentation [v0.41.x]"
+type: docs
+---

docs/content/en/docs-v0.41.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.

docs/content/en/docs-v0.41.x/contribution-guidelines/_index.md

@@ -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!
+---

docs/content/en/docs-v0.41.x/contribution-guidelines/architectural-overview.md

@@ -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/).

docs/content/en/docs-v0.41.x/contribution-guidelines/contributing.md

@@ -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.

docs/content/en/docs-v0.41.x/contribution-guidelines/development.md

@@ -0,0 +1,94 @@
+---
+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](https://www.docker.com/)
+- [kind](https://kind.sigs.k8s.io/docs/user/quick-start/#installation) (If you want to run Control Plane locally)
+- [helm 3.8](https://helm.sh/docs/intro/install/) (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.