-
Notifications
You must be signed in to change notification settings - Fork 152
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Add blog entry of terraform-module-pipecd
Signed-off-by: Kenta Kozuka <[email protected]>
- Loading branch information
1 parent
efc6848
commit 6304354
Showing
1 changed file
with
73 additions
and
0 deletions.
There are no files selected for viewing
73 changes: 73 additions & 0 deletions
73
docs/content/en/blog/terraform-module-for-pipecd-is-out.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,73 @@ | ||
--- | ||
date: 2023-07-20 | ||
title: "Terraform Module for PipeCD is Out!" | ||
linkTitle: "Terraform Module for PipeCD is Out" | ||
weight: 991 | ||
description: "Terraform Module for PipeCD is Out" | ||
author: Kenta Kozuka ([@kentakozuka](https://twitter.com/kenta_kozuka)) | ||
--- | ||
|
||
Now PipeCD resources can be managed by Terraform🎉 | ||
|
||
[terraform-module-pipecd](https://github.com/pipe-cd/terraform-provider-pipecd), which is a Terraform module for PipeCD, has been released! | ||
Thanks to [@arabian9ts](https://github.com/arabian9ts), [@kurochan](https://twitter.com/kuro_m88), and [@sivchari](https://twitter.com/sivchari) for creating this module! | ||
|
||
Until now, there were two methods for adding or updating piped and applications in PipeCD: manually accessing the Control Plane through a browser or using the provided CLI, pipectl. While these methods were intuitive and easy to understand, they had the drawback of being prone to operational errors as the number of managed piped and applications increased. Even incorporating pipectl into shell scripts resulted in a procedural approach. It's not very cool to have a tool that provides GitOps capabilities but can't be managed using GitOps principles, right? | ||
|
||
The newly released terraform-module-pipecd addresses these issues. With this module, you can easily deploy PipeCD resources using the declarative syntax of Terraform. | ||
|
||
Using terraform-module-pipecd, you can enjoy the following benefits: | ||
1. **Easy deployment**: It simplifies the process of deploying PipeCD. | ||
2. **Declarative code management**: By managing it as code, you can track changes and reviews through pull requests. | ||
3. **Integration with continuous deployment**: When combined with CI/CD tools, it enables automation of configuration testing and the addition or modification of PipeCD resources. | ||
|
||
Currently, the PipeCD resources that can be managed with terraform-module-pipecd are: | ||
- Piped Agent | ||
- Application | ||
|
||
In the future, based on community demand, more resources that can be managed might be added. Please try out the module and provide feedback on Github. | ||
|
||
## How to Use | ||
While this blog post doesn't delve into detailed usage, it provides an example of registering a CloudRun Application with PipeCD using HCL code: | ||
|
||
```hcl | ||
// Setup the module | ||
terraform { | ||
required_providers { | ||
pipecd = { | ||
source = "pipe-cd/pipecd" | ||
version = "0.1.0" | ||
} | ||
} | ||
required_version = ">= 1.4" | ||
} | ||
// Declaration of CloudRun Application | ||
resource "pipecd_application" "main" { | ||
kind = "CLOUDRUN" | ||
name = "example-application" | ||
description = "This is the simple application" | ||
platform_provider = "cloudrun-inproject" | ||
piped_id = "your-piped-id" | ||
git = { | ||
repository_id = "examples" | ||
remote = "[email protected]:pipe-cd/examples.git" | ||
branch = "master" | ||
path = "cloudrun/simple" | ||
filename = "app.pipecd.yaml" | ||
} | ||
} | ||
``` | ||
|
||
With this simple code, you can define the configuration information for an application. Then, just use the `terraform` command to perform an `apply`. | ||
|
||
For more details, check out the [documentation]() and the [example](https://github.com/pipe-cd/terraform-provider-pipecd/tree/main/example) in the repository. | ||
|
||
Please watch our Community Meeting #2. [@arabian9ts](https://github.com/arabian9ts), a maintainer of terraform-module-pipecd is explaining how to add an application step by step. | ||
|
||
{{< youtube B8NWgzLNe_o>}} | ||
|
||
## Born in the Community | ||
This project was originally developed by [@arabian9ts](https://github.com/arabian9ts), [@kurochan](https://github.com/kurochan), and [@sivchari](https://github.com/sivchari) to make the PipeCD's management better, and later donated to the pipe-cd organization. Many thanks for their contribution! (And They stay to be the maintainer of the projects to improve it more. How amazing is it?) | ||
|
||
PipeCD is supported by the power of such community efforts. We encourage everyone to join the PipeCD community and participate. |