# CDKTF CDK8s
 [](https://github.com/cdktf/cdktf-cdk8s/releases)
[](https://github.com/cdktf/cdktf-cdk8s/blob/main/LICENSE)
[](https://github.com/cdktf/cdktf-cdk8s/actions/workflows/build.yml)
A compatibility layer for using [cdk8s](https://cdk8s.io/) constructs within Terraform CDK.
The cdk8s adapter is in technical preview, which means it's a community supported project. It still requires extensive testing and polishing to mature into a HashiCorp officially supported project. Please [file issues](https://github.com/cdktf/cdktf-cdk8s/issues/new/choose) generously and detail your experience while using the library. We welcome your feedback.
By using the software in this repository, you acknowledge that:
* The cdk8s adapter is still in development, may change, and has not been released as a commercial product by HashiCorp and is not currently supported in any way by HashiCorp.
* The cdk8s adapter is provided on an "as-is" basis, and may include bugs, errors, or other issues.
* The cdk8s adapter is NOT INTENDED FOR PRODUCTION USE, use of the Software may result in unexpected results, loss of data, or other unexpected results, and HashiCorp disclaims any and all liability resulting from use of the cdk8s adapter.
* HashiCorp reserves all rights to make all decisions about the features, functionality and commercial release (or non-release) of the cdk8s adapter, at any time and without any obligation or liability whatsoever.
## Compatibility
* `cdktf` >= 0.20.0
* `cdk8s` >= 2.8.0
* `constructs` >= 10.3.0
## Usage
```python
import { App, TerraformStack } from "cdktf";
import { App as CDK8sApp, Chart } from "cdk8s";
import { CDK8sProvider } from "cdktf-cdk8s";
import { MyCdk8sChart } from "./my-cdk8s-chart";
export class MyKubernetesStack extends TerraformStack {
constructor(scope: Construct, name: string) {
super(scope, name);
const cdk8sApp = new CDK8sApp();
// Configure your cdk8s application like usual
new HelloKube(cdk8sApp, "my-chart");
// For properties see https://registry.terraform.io/providers/hashicorp/kubernetes/latest/docs
// Extends on the Provider class from @cdktf/provider-kubernetes
new CDK8sProvider(this, "cdk8s-dev", {
configPath: "./kubeconfig.yaml",
configContext: "my-dev-cluster",
// Only the cdk8sApp property is added
// There is no need to run synth on the cdk8sApp, this is done by the provider
cdk8sApp,
});
}
}
const app = new App();
new MyStack(app, "cdktf-cdk8s");
app.synth();
```
## Contributing
We welcome your contribution. Please understand that the experimental nature of this repository means that contributing code may be a bit of a moving target. If you have an idea for an enhancement or bug fix, and want to take on the work yourself, please first [create an issue](https://github.com/cdktf/cdktf-cdk8s/issues/new/choose) so that we can discuss the implementation with you before you proceed with the work.
You can review our [contribution guide](https://github.com/cdktf/.github/blob/main/CONTRIBUTING.md) to begin.
Raw data
{
"_id": null,
"home_page": "https://github.com/cdktf/cdktf-cdk8s.git",
"name": "cdktf-cdk8s",
"maintainer": null,
"docs_url": null,
"requires_python": "~=3.8",
"maintainer_email": null,
"keywords": null,
"author": "HashiCorp",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/3f/46/8423a531f2c13ff22fc6aac3adcf5488077a48bd1761e62e9919c7d796a0/cdktf-cdk8s-0.10.16.tar.gz",
"platform": null,
"description": "# CDKTF CDK8s\n\n [](https://github.com/cdktf/cdktf-cdk8s/releases)\n[](https://github.com/cdktf/cdktf-cdk8s/blob/main/LICENSE)\n[](https://github.com/cdktf/cdktf-cdk8s/actions/workflows/build.yml)\n\nA compatibility layer for using [cdk8s](https://cdk8s.io/) constructs within Terraform CDK.\n\nThe cdk8s adapter is in technical preview, which means it's a community supported project. It still requires extensive testing and polishing to mature into a HashiCorp officially supported project. Please [file issues](https://github.com/cdktf/cdktf-cdk8s/issues/new/choose) generously and detail your experience while using the library. We welcome your feedback.\n\nBy using the software in this repository, you acknowledge that:\n\n* The cdk8s adapter is still in development, may change, and has not been released as a commercial product by HashiCorp and is not currently supported in any way by HashiCorp.\n* The cdk8s adapter is provided on an \"as-is\" basis, and may include bugs, errors, or other issues.\n* The cdk8s adapter is NOT INTENDED FOR PRODUCTION USE, use of the Software may result in unexpected results, loss of data, or other unexpected results, and HashiCorp disclaims any and all liability resulting from use of the cdk8s adapter.\n* HashiCorp reserves all rights to make all decisions about the features, functionality and commercial release (or non-release) of the cdk8s adapter, at any time and without any obligation or liability whatsoever.\n\n## Compatibility\n\n* `cdktf` >= 0.20.0\n* `cdk8s` >= 2.8.0\n* `constructs` >= 10.3.0\n\n## Usage\n\n```python\nimport { App, TerraformStack } from \"cdktf\";\nimport { App as CDK8sApp, Chart } from \"cdk8s\";\nimport { CDK8sProvider } from \"cdktf-cdk8s\";\n\nimport { MyCdk8sChart } from \"./my-cdk8s-chart\";\n\nexport class MyKubernetesStack extends TerraformStack {\n constructor(scope: Construct, name: string) {\n super(scope, name);\n\n const cdk8sApp = new CDK8sApp();\n\n // Configure your cdk8s application like usual\n new HelloKube(cdk8sApp, \"my-chart\");\n\n // For properties see https://registry.terraform.io/providers/hashicorp/kubernetes/latest/docs\n // Extends on the Provider class from @cdktf/provider-kubernetes\n new CDK8sProvider(this, \"cdk8s-dev\", {\n configPath: \"./kubeconfig.yaml\",\n configContext: \"my-dev-cluster\",\n\n // Only the cdk8sApp property is added\n // There is no need to run synth on the cdk8sApp, this is done by the provider\n cdk8sApp,\n });\n }\n}\n\nconst app = new App();\nnew MyStack(app, \"cdktf-cdk8s\");\napp.synth();\n```\n\n## Contributing\n\nWe welcome your contribution. Please understand that the experimental nature of this repository means that contributing code may be a bit of a moving target. If you have an idea for an enhancement or bug fix, and want to take on the work yourself, please first [create an issue](https://github.com/cdktf/cdktf-cdk8s/issues/new/choose) so that we can discuss the implementation with you before you proceed with the work.\n\nYou can review our [contribution guide](https://github.com/cdktf/.github/blob/main/CONTRIBUTING.md) to begin.\n",
"bugtrack_url": null,
"license": "MPL-2.0",
"summary": "A compatibility layer for using cdk8s constructs within Terraform CDK.",
"version": "0.10.16",
"project_urls": {
"Homepage": "https://github.com/cdktf/cdktf-cdk8s.git",
"Source": "https://github.com/cdktf/cdktf-cdk8s.git"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "8c8a9e9562d0c77e3b42f10439dc11637a6dcdb2dbb0df952d64c430dcbbf891",
"md5": "19aeaae3d9edffd807e84a5d284b99b9",
"sha256": "6e7e097747af33d82c1ce3d9df11c68f3e93516949f57fdd0dee84f848adecca"
},
"downloads": -1,
"filename": "cdktf_cdk8s-0.10.16-py3-none-any.whl",
"has_sig": false,
"md5_digest": "19aeaae3d9edffd807e84a5d284b99b9",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "~=3.8",
"size": 137238,
"upload_time": "2024-04-22T00:26:11",
"upload_time_iso_8601": "2024-04-22T00:26:11.185837Z",
"url": "https://files.pythonhosted.org/packages/8c/8a/9e9562d0c77e3b42f10439dc11637a6dcdb2dbb0df952d64c430dcbbf891/cdktf_cdk8s-0.10.16-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "3f468423a531f2c13ff22fc6aac3adcf5488077a48bd1761e62e9919c7d796a0",
"md5": "fea68980f91e540f61420623d3812bdd",
"sha256": "c26c99c897ff6a28c048a1298638c5758446a4e15dfc4eb83e81476ca5fc6882"
},
"downloads": -1,
"filename": "cdktf-cdk8s-0.10.16.tar.gz",
"has_sig": false,
"md5_digest": "fea68980f91e540f61420623d3812bdd",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "~=3.8",
"size": 139406,
"upload_time": "2024-04-22T00:26:14",
"upload_time_iso_8601": "2024-04-22T00:26:14.184807Z",
"url": "https://files.pythonhosted.org/packages/3f/46/8423a531f2c13ff22fc6aac3adcf5488077a48bd1761e62e9919c7d796a0/cdktf-cdk8s-0.10.16.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-22 00:26:14",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "cdktf",
"github_project": "cdktf-cdk8s",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "cdktf-cdk8s"
}
JSON
