{"id":19817110,"url":"https://github.com/kbst/terraform-provider-kustomization","last_synced_at":"2026-01-12T06:33:00.337Z","repository":{"id":37042841,"uuid":"226523985","full_name":"kbst/terraform-provider-kustomization","owner":"kbst","description":"Terraform provider for Kustomize","archived":false,"fork":false,"pushed_at":"2024-12-18T14:12:34.000Z","size":783,"stargazers_count":275,"open_issues_count":10,"forks_count":56,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-04-12T04:46:40.234Z","etag":null,"topics":["gitops-framework","hacktoberfest","kubernetes","kustomize","terraform","terraform-framework","terraform-provider"],"latest_commit_sha":null,"homepage":"https://www.kubestack.com","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kbst.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-12-07T14:08:57.000Z","updated_at":"2025-03-20T19:00:25.000Z","dependencies_parsed_at":"2024-02-03T03:26:56.210Z","dependency_job_id":"354e5e0a-fbda-4a36-a3ef-d9f0a56a8df6","html_url":"https://github.com/kbst/terraform-provider-kustomization","commit_stats":null,"previous_names":["kbst/terraform-provider-kustomize"],"tags_count":62,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kbst%2Fterraform-provider-kustomization","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kbst%2Fterraform-provider-kustomization/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kbst%2Fterraform-provider-kustomization/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kbst%2Fterraform-provider-kustomization/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kbst","download_url":"https://codeload.github.com/kbst/terraform-provider-kustomization/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254485054,"owners_count":22078767,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["gitops-framework","hacktoberfest","kubernetes","kustomize","terraform","terraform-framework","terraform-provider"],"created_at":"2024-11-12T10:11:39.736Z","updated_at":"2026-01-12T06:33:00.330Z","avatar_url":"https://github.com/kbst.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n \u003cimg src=\"./assets/favicon.png\" alt=\"Kubestack, The Open Source Gitops Framework\" width=\"25%\" height=\"25%\" /\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eTerraform Provider Kustomize\u003c/h1\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n[![Status](https://img.shields.io/badge/status-active-success.svg)]()\n![Run Tests](https://github.com/kbst/terraform-provider-kustomize/workflows/Run%20Tests/badge.svg?branch=master\u0026event=push)\n[![GitHub Issues](https://img.shields.io/github/issues/kbst/terraform-provider-kustomization.svg)](https://github.com/kbst/terraform-provider-kustomization/issues)\n[![GitHub Pull Requests](https://img.shields.io/github/issues-pr/kbst/terraform-provider-kustomization.svg)](https://github.com/kbst/terraform-provider-kustomization/pulls)\n\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n![GitHub Repo stars](https://img.shields.io/github/stars/kbst/terraform-provider-kustomization?style=social)\n![Twitter Follow](https://img.shields.io/twitter/follow/kubestack?style=social)\n\n\u003c/div\u003e\n\n\n\u003ch3 align=\"center\"\u003e\u003ca href=\"#Contributing\"\u003eJoin Our Contributors!\u003c/a\u003e\u003c/h3\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n\u003ca href=\"https://github.com/kbst/terraform-provider-kustomization/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contrib.rocks/image?repo=kbst/terraform-provider-kustomization\u0026max=36\" /\u003e\n\u003c/a\u003e\n\n\u003c/div\u003e\n\n## Introduction\n\nThe Terraform provider for Kustomize is available from the [Terraform registry](https://registry.terraform.io/providers/kbst/kustomization/latest).\n\nPlease refer to the [documentation](https://registry.terraform.io/providers/kbst/kustomization/latest/docs) for information on how to use the `kustomization_build` and `kustomization_overlay` data sources, or the `kustomization_resource` resource.\n\nThis is a standalone Terraform Provider, but is also used in the [Terraform GitOps framework Kubestack](https://www.kubestack.com/).\n\n\n## Getting Help\n\n**Community Help**  \nIf you have any questions while following the tutorial, join the [#kubestack](https://app.slack.com/client/T09NY5SBT/CMBCT7XRQ) channel on the Kubernetes community. To create an account request an [invitation](https://slack.k8s.io/).\n\n**Professional Services**  \nFor organizations interested in accelerating their GitOps journey, [professional services](https://www.kubestack.com/lp/professional-services) are available.\n\n\n## Contributing\nContributions to the Kubestack framework are welcome and encouraged. Before contributing, please read the [Contributing](./CONTRIBUTING.md) and [Code of Conduct](./CODE_OF_CONDUCT.md) Guidelines.\n\nOne super simple way to contribute to the success of this project is to give it a star.  \n\n\u003cdiv align=\"center\"\u003e\n\n![GitHub Repo stars](https://img.shields.io/github/stars/kbst/terraform-provider-kustomization?style=social)\n\n\u003c/div\u003e\n\n\n## Development Requirements\n\n- [Terraform](https://www.terraform.io/downloads.html) 0.12.x\n- [Go](https://golang.org/doc/install) 1.13 (to build the provider plugin)\n\n\n## Building and Developing the Provider\n\nTo work on the provider, you need go installed on your machine. The provider uses go mod to manage its dependencies, so GOPATH is not required.\n\nTo compile the provider, run `make build` as shown below. This will build the provider and put the provider binary in the `terraform.d/plugins/linux_amd64/` directory.\n\n```sh\nmake build\n```\n\nIn order to test the provider, run the acceptance tests using `make test`. You have to set the `KUBECONFIG_PATH` environment variable to point the tests to a valid config file. Each tests uses an individual namespaces. [Kind](https://github.com/kubernetes-sigs/kind) or [Minikube](https://github.com/kubernetes/minikube) clusters work well for testing.\n\n```sh\nmake test\n```\n\n### Running the provider under debug\n\nRunning in debug mode is a four step process - launch the plugin in debug mode under delve, connect your IDE to delve, connect terraform to the plugin, and\nthen run terraform. Instructions here are for Visual Studio Code, configuring other IDEs is likely to be a similar process\n\n* Ensure you have [`delve` installed](https://github.com/go-delve/delve/tree/master/Documentation/installation)\n* Build the plugin locally using `go build ./...`\n* From the terraform repository you wish to debug, run the following\n  ```\n  PLUGIN_PROTOCOL_VERSIONS=5 dlv exec --api-version=2 --listen=127.0.0.1:49188 --headless /path/to/terraform-provider-kustomization/terraform-provider-kustomize -- --debug\n  ```\n  If you run this outside of the terraform repository (e.g. in the plugin source directory), kustomize gets very confused when trying to find files\n* In Visual Studio Code, add the [following configuration to launch.json](https://code.visualstudio.com/docs/editor/debugging#_launch-configurations)\n  ```\n    {\n        \"name\": \"Connect to server\",\n        \"type\": \"go\",\n        \"request\": \"attach\",\n        \"mode\": \"remote\",\n        \"remotePath\": \"${workspaceFolder}\",\n        \"port\": 49188,\n        \"host\": \"127.0.0.1\",\n        \"apiVersion\": 2,\n        \"env\": {\n            \"KUBECONFIG_PATH\": \"${HOME}/.kube/config\"\n        },\n        \"dlvLoadConfig\": {\n            \"followPointers\": true,\n            \"maxVariableRecurse\": 1,\n            \"maxStringLen\": 512,\n            \"maxArrayValues\": 64,\n            \"maxStructFields\": -1\n        }\n    }\n  ```\n* Click the debug button and start `Connect to server`.\n* From the terminal you started `dlv` from, you will see something like:\n  ```\n  Provider server started; to attach Terraform, set TF_REATTACH_PROVIDERS to the following:\n  {\"registry.terraform.io/kbst/kustomization\":{\"Protocol\":\"grpc\",\"Pid\":13366,\"Test\":true,\"Addr\":{\"Network\":\"unix\",\"String\":\"/var/folders/7c/wdp684z11w1_6cj0d6lgl8hw0000gn/T/plugin2650218557\"}}}\n  ```\n  Set this value using export `TF_REATTACH_PROVIDERS={\"registry...}}}` in the terminal you want to run terraform from\n* Set any breakpoints you wish to use\n* Run terraform\n\n\n### Running a specific test in debug mode\n\n* Add the following configuration to .vscode/launch.json, updating the `TestFunctionNameGoesHere`\n  to the name of the function you want to test:\n\n  ```\n  {\n      \"name\": \"Launch test function\",\n      \"type\": \"go\",\n      \"request\": \"launch\",\n      \"mode\": \"test\",\n      \"program\": \"${workspaceFolder}/kustomize\",\n      \"env\": {\n          \"TF_ACC\": \"1\",\n          \"KUBECONFIG_PATH\": \"${env:HOME}/.kube/config\"\n      },\n      \"args\": [\n          \"-test.v\",\n          \"-test.run\",\n          \"^TestFunctionNameGoesHere$\",\n      ],\n  }\n  ```\n* Set any breakpoints you want to set\n* Click the debug button and choose \"Launch test function\" in the dropdown\n\n## Kubestack Repositories\n* [kbst/terraform-kubestack](https://github.com/kbst/terraform-kubestack)  \n    * Terraform GitOps Framework - Everything you need to build reliable automation for AKS, EKS and GKE Kubernetes clusters in one free and open-source framework.\n* [kbst/kbst](https://github.com/kbst/kbst)  \n    * Kubestack Framework CLI - All-in-one CLI to scaffold your Infrastructure as Code repository and deploy your entire platform stack locally for faster iteration.\n* [kbst/terraform-provider-kustomization](https://github.com/kbst/terraform-provider-kustomization) (this repository)  \n    * Kustomize Terraform Provider - A Kubestack maintained Terraform provider for Kustomize, available in the [Terraform registry](https://registry.terraform.io/providers/kbst/kustomization/latest).\n* [kbst/catalog](https://github.com/kbst/catalog)  \n    * Catalog of cluster services as Kustomize bases - Continuously tested and updated Kubernetes services, installed and customizable using native Terraform syntax.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkbst%2Fterraform-provider-kustomization","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkbst%2Fterraform-provider-kustomization","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkbst%2Fterraform-provider-kustomization/lists"}