Getting Started with Pluralith and Google Cloud

2023年7月1回目です。

今週も「積読」ならぬ、「積Issue」を減らす個人的なメモです。

Pluralith についてです。

Pluralith は、Visualize Tool です。

Visualize Tool は、これまで色々な Tool が出てきました。
例えば、draw.io や D2 、rediagram など。

どれも一長一短で、ぼく個人的には、「SVG で管理できれば良いか、、、」というところで、draw.io に戻っていました。

Pluralith について、これまでの Tool との違いを見ていきます。

Installation

Sign up

• アカウントを作成します。
• 「Local Setup」を選択します。
• 画面に表示されている API KEY をコピーします。

export PLURALITH_API_KEY="27d5073882200f14172b7acc0e8caabc"
echo $PLURALITH_API_KEY

Install CLI

curl -L -o pluralith https://github.com/Pluralith/pluralith-cli/releases/download/v0.2.2/pluralith_cli_linux_amd64_v0.2.2
chmod +x pluralith 
./pluralith login --api-key $PLURALITH_API_KEY

Usage

• Google のチュートリアルを使います。
  Terraform を使用して基本的な Flask ウェブサーバーをデプロイする

• 使用した main.tf はこちら。

terraform plan

gcp_iam_verifier@cloudshell:~/tf-tutorial (sandbox-pluralith)$ terraform plan

terrafrom apply

gcp_iam_verifier@cloudshell:~/tf-tutorial (sandbox-pluralith)$ terraform apply

graph

gcp_iam_verifier@cloudshell:~/tf-tutorial (sandbox-pluralith)$ ./pluralith graph                                                                                                    
⠿ Initiating Graph ⇢ Posting Diagram To Pluralith Dashboard

→ Authentication
  ✔ API key is valid, you are authenticated!

→ Plan
  ✔ Local Execution Plan Generated
  ✔ Local Plan Cache Created
  ✔ Secrets Stripped
  - Cost Calculation Skipped

→ Graph
  ✔ Local Diagram Generated
  ✔ Diagram Posted To Pluralith Dashboard

  → Diagram Pushed To: https://app.pluralith.com/#/orgs/888888888/projects/pluralith-local-project/runs/9999999/
exec: "xdg-open": executable file not found in $PATH
gcp_iam_verifier@cloudshell:~/tf-tutorial (sandbox-pluralith)$ 

• graph command 実行後に表示される URI をクリックすると、生成された diagram が表示されます。
  
• 画面左下の「EXPORT PNG」をクリックすると、EXPORT 画面が表示されます。
  
  

Summary

Pluralith について書きました。
CLI を使えれば、必要な時に構成図を自動で生成できます。
特に、管理する Resource が増えていくと、maintenance が面倒になる傾向があると思います。
そんな時は、Pluralith を使えば、CLI 一発で生成してくれます。