---
title: "Terraform のリモートデプロイ実行環境を提供する OSS、Terrakube を検証してみた | grasys blog"
url: "https://blog.grasys.io/post/oshima/verify-terrakube"
description: "はじめに こんにちは、大島です。 grasys では、インフラストラクチャのリソース管理として Terraform を利用しています。Terraform のリモートデプロイ実行環境としてこのたび OSS である Terrakube を見つけました。その Terrakube について紹介したいと思います。 HCP Te…"
---

# Terraform のリモートデプロイ実行環境を提供する OSS、Terrakube を検証してみた

-   ![](/_astro/noicon.CTHOhNiB_1HMs6A.webp)[Oshima](/authors/oshima/)
-   公開日：2025年9月2日
-   カテゴリー：[Tech](/categories/tech/)
-   タグ：[#Terraform](/tags/terraform/)[#Terrakube](/tags/terrakube/)

![Terraform のリモートデプロイ実行環境を提供する OSS、Terrakube を検証してみた](/_astro/hero.BnVboJwT_1ALtFA.webp)

## はじめに

こんにちは、大島です。

grasys では、インフラストラクチャのリソース管理として Terraform を利用しています。Terraform のリモートデプロイ実行環境としてこのたび OSS である Terrakube を見つけました。その Terrakube について紹介したいと思います。

HCP Terraform ライクな仕上がりになっていて、Kubernetes で運用できるところも私としてはポイント高いです。Kubernetes 大好きです。

※本記事は、Terraform エコシステムに関連する OSS「Terrakube」を技術的に検証した内容です。公式にサポート・推奨するものではなく、HashiCorp 社が提供する Terraform / HCP Terraform が当社の主要な取り扱いソリューションであることを前提としています。

## Terrakube とは

[Terrakube](https://terrakube.io/) は、Kubernetes 上で実行できる、Terraform や OpenTofu のリモート実行環境 を提供する OSS です。

![Terrakube Workspaceの画面](/_astro/01-81824fac449300894505659e2499c573-1024x537-be4b7f5f.s7f__wAN_1R85PD.webp)

## 機能

### ユーザー管理

Terrakube では、ユーザー認証に [Dex](https://dexidp.io/) が使われています。  
grasys は、Google アカウントを使っているので、Dex connector で Google の OIDC と接続することで、Google アカウントを使って Terrakube にログインできるようになっています。

素晴らしいです。ありがとうございます。

![Dexアーキテクチャ図](/_astro/02-image-1024x473-ddceea54.C6vE_onR_Z1bsIJy.webp)

[https://dexidp.io/docs/](https://dexidp.io/docs/)

Dex connector で接続できるプロバイダは他にもいろいろあります。  
[公式ドキュメント](https://dexidp.io/docs/connectors/)をご参照ください。

Terrakube 上で操作するユーザーに対して、管理者や開発者など、権限を分けたいですよね。  
Terrakube では Team という機能で提供しています。

Google Group と組み合わせることで、グループに所属するユーザー全体に一括で権限を設定できました。

![Terrakube Teamの画面](/_astro/03-12931ec9856aa1cc54e91fc06275da13-1-1024x418-543824b5.DVzc6-bv_1kAQnp.webp)

### OPA

grasysでは、[Open Policy Agent](https://www.openpolicyagent.org/) を使ってデプロイ前にバリデーションチェックを行なっています。

Terrakube では、Template という機能を使って CI/CD パイプラインを作成します。そこで OPA を利用することができました。

### Template

Template は、Terrakube の各ワークスペースの CI/CD パイプラインを提供します。YAML 形式 でステップを記述する、よくある形になっています。ステップ内のスクリプトの記述には BASH や GROOVY をサポートしています。

スクリプトを書けるので、上記のように OPA を実行したり、Slack へ通知したり、他にもいろいろとできるようです。

例えば、Planを実行後、特定のユーザーの承認を経て実環境にデプロイしたい場合が考えられます。その場合はこのような内容になります。

Plain textcontent\_copy

```
flow:
  - type: "terraformPlan"
    step: 100
    name: "Plan"
  - type: "approval"
    step: 150
    team: "xxxxxx@grasys.io"
    name: "Approval"
  - type: "terraformApply"
    step: 200
    name: "Apply"
```

### Drift Detection

HCP Terraform でも機能としてあります、Drift Detection、Terrakube にもありました。  
CI/CD パイプライン定義である Template と、Template を定期的に実行するスケジュールという機能を使って、定期的に Plan を実行することで、いつの間にか発生していた差分に気づくことができます。

気づきたいです、差分。

### Dynamic Provider Credentials

デプロイする環境にアクセスする方法に、クラウドプロバイダのサービスアカウントのシークレットキーを使う方法がありますが、その場合、シークレットキーの情報をどこかで保持して設定する必要があります。

漏洩の危険があり、セキュアじゃないです。

Dynamic Provider Credentials では、サービスアカウントのシークレットキーではなく、フェデレーション ID を使って動的にクライアントを認証します。シークレットキーを管理する必要も、作成する必要もなくなります。

積極的に使いたいです。

Terrakube で利用するには、[Terrakube の設定](https://docs.terrakube.io/user-guide/workspaces/dynamic-provider-credentials)と、[Workspace の設定](https://github.com/terrakube-io/terrakube/tree/main/dynamic-credential-setup)が必要になります。

### プライベートレジストリ

Terraform モジュールをプライベートに公開して利用できます。HCP Terraform にもありますね。  
grasys でも、組織内で横断的にモジュールを再利用したいため、とても嬉しいです。

### Terraform

Terrakube を設定するための [Terraform](https://registry.terraform.io/providers/AzBuilder/terrakube/latest/docs) を公開してくれています。ただ、エラー文はちょっと微妙です。

Plain textcontent\_copy

```
╷
│ Error: Error unmarshal payload response
│
│   with module.workspace.terrakube_workspace_tag.main["xxx"],
│   on ../../../modules/workspace/main.tf line 15, in resource "terrakube_workspace_tag" "main":
│   15: resource "terrakube_workspace_tag" "main" {
│
│ Error unmarshal payload response: data is not a jsonapi representation of '*client.WorkspaceTagEntity'
```

この時のエラーは、タグが存在しないか、あるいは、タグが既に設定されているかの時に発生しました。

GUI で操作すると操作履歴を残さないと再現性がなくなってしまうので私は IaC が大好きです。エラー文が微妙なことには目を瞑りましょう。不満があればコントリビュートすれば良いのです。OSS なので。

## 移行について

HCP Terraform で作成したワークスペースをそのまま Terrakube にインポートすることができます。

![Terrakube Workspaceインポートの画面](/_astro/04-7a1fd48763c4236b08a7c8e8a9225fc6-1024x418-dc813103.IjuLtK3i_ZRo4sq.webp)

しかし、ワークスペースに設定している環境変数など、インポートしたそのままでヨシ！にはならず、あとちょっとのところが微妙に手が届かない、そんな歯痒さがありました。

結局、インポートした後、設定し直す作業が発生してしまいました。  
全てを設定し直す必要がないのはいいですね。

## 最後に

Terrakube の全ては紹介できていませんが、どんなものなのかおおよその想像がついたのではないかなと思います。

SaaS は自分たちで管理しなくて良い分、料金は上がります。OSS は自分たちで構築運用保守の手間がありますが、料金としては安くなります。そこのトレードオフだと思いますが、Terrakube は、HCP Terraform の諸々の機能をカバーするように機能が充実しており、すごく頑張っているなと感じました。

なにを優先するかで Terrakube なのか、HCP Terraform なのか、はたまた別のものなのか選択していただけたらと思います。快適な IaC ライフをお過ごしください。

## この記事を書いた人

[![](/_astro/noicon.CTHOhNiB_Z24aAgM.webp)](/authors/oshima/)

### [Oshima](/authors/oshima/)

Oshimaのプロフィールと執筆記事をご覧いただけます。

[プロフィールと記事一覧](/authors/oshima/)