{"id":20468476,"url":"https://github.com/unikraft-cloud/terraform-provider-unikraftcloud","last_synced_at":"2025-04-13T10:25:46.547Z","repository":{"id":200473999,"uuid":"703442249","full_name":"unikraft-cloud/terraform-provider-unikraftcloud","owner":"unikraft-cloud","description":"Terraform Provider for KraftCloud","archived":false,"fork":false,"pushed_at":"2025-03-09T09:36:33.000Z","size":248,"stargazers_count":2,"open_issues_count":4,"forks_count":1,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-03-27T01:47:58.065Z","etag":null,"topics":["terraform","unikernel"],"latest_commit_sha":null,"homepage":"https://registry.terraform.io/providers/unikraft-cloud","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/unikraft-cloud.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"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":"2023-10-11T08:54:16.000Z","updated_at":"2024-10-18T21:54:19.000Z","dependencies_parsed_at":"2024-02-25T10:33:38.289Z","dependency_job_id":"9fdf3390-ec98-4457-a4b8-5a6b4ce554ec","html_url":"https://github.com/unikraft-cloud/terraform-provider-unikraftcloud","commit_stats":null,"previous_names":["kraftcloud/terraform-provider-kraftcloud","unikraft-cloud/terraform-provider-unikraft-cloud","unikraft-cloud/terraform-provider-unikraftcloud"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unikraft-cloud%2Fterraform-provider-unikraftcloud","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unikraft-cloud%2Fterraform-provider-unikraftcloud/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unikraft-cloud%2Fterraform-provider-unikraftcloud/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unikraft-cloud%2Fterraform-provider-unikraftcloud/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/unikraft-cloud","download_url":"https://codeload.github.com/unikraft-cloud/terraform-provider-unikraftcloud/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248696963,"owners_count":21147223,"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":["terraform","unikernel"],"created_at":"2024-11-15T14:05:36.921Z","updated_at":"2025-04-13T10:25:46.494Z","avatar_url":"https://github.com/unikraft-cloud.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ca href=\"https://kraft.cloud\"\u003e\n    \u003cimg src=\"https://avatars3.githubusercontent.com/unikraft-cloud\" alt=\"Unikraft Cloud logo\" title=\"Unikraft Cloud\" align=\"right\" height=\"50\" /\u003e\n\u003c/a\u003e\n\n# Terraform Provider for Unikraft Cloud\n\nThe Unikraft Cloud provider allows Terraform to manage unikernel instances on Unikraft Cloud.\n\n## Usage\n\nPlease refer to the [`unikraft-cloud` provider documentation][tfreg-docs] in the Terraform Registry.\n\n## Development\n\nThis provider is built on top of the [Terraform Plugin Framework][tffw-home].\n\nIf you are unfamiliar with the framework, or with extending Terraform with providers in general, we recommend looking\ninto the [Custom Framework Providers tutorial][tffw-tuto] on the HashiCorp Developer portal as a starting point.\n\n### Requirements\n\n- [Terraform][tf-dl] \u003e= 1.4\n- [Go][go-dl] \u003e= 1.21\n\n### Local Installation\n\nTerraform usually installs providers by downloading them from a registry. However, it can be configured to use a [local\ndevelopment build][tffw-local] of the provider, which allows skipping the version and checksum checks typically\nperformed against release builds.\n\nTo achieve this, add a `dev_overrides` entry to your `~/.terraformrc` configuration file:\n\n```hcl\nprovider_installation {\n\n  dev_overrides {\n      # The value is the path of $GOBIN (or $GOPATH/bin)\n      \"unikraft.cloud/dev/unikraft-cloud\" = \"/home/myuser/go/bin\"\n  }\n\n  # For all other providers, install them directly from their origin provider\n  # registries as normal. If you omit this, Terraform will _only_ use\n  # the dev_overrides block, and so no other providers will be available.\n  direct {}\n}\n```\n\n\u003e [!NOTE]\n\u003e We deliberately use the provider address `unikraft.cloud/dev/unikraft-cloud` instead of\n\u003e `registry.terraform.io/unikraft-cloud/unikraft-cloud` in a development context. This allows switching more conveniently\n\u003e between the local development build and the release build of this provider.\n\nTerraform will now resolve the provider source `kraft.cloud/dev/unikraft-cloud` to the local development build, instead of\nthe remote provider from the Terraform Registry, such as in the example below:\n\n```hcl\nterraform {\n  required_providers {\n    unikraft-cloud = {\n      source = \"kraft.cloud/dev/unikraft-cloud\"\n    }\n  }\n}\n```\n\n### Testing\n\nThis provider includes [Acceptance Tests][tffw-acc] that perform lifecycle actions using real Terraform configurations,\nagainst real Unikraft Cloud resources.\n\n**It is mandatory to have access to a Unikraft Cloud account to execute these tests.**\n\nAcceptance tests are executed using the `testacc` Make target:\n\n```sh\nmake testacc\n```\n\nAll acceptance tests are run by default. The `TESTARGS` variable can be used to pass arbitrary arguments to `go test`\n(see [Testing flags][gotest-flags]). For example, use the `-run` flag to run specific tests:\n\n```sh\nmake testacc TESTARGS='-run=TestAccInstanceResource'\n```\n\n### Documentation\n\nThe documentation of this provider, including its resources and data sources, is generated using the [`tfplugindocs` CLI\ntool][tfplugindocs].\n\nTo run the documentation generator, execute the `go generate` command. The output is written to the `docs/` directory.\n\nThe generator uses the templates from the `templates/` directory and the following data to populate the provider's\ndocumentation pages:\n\n- Examples inside the `examples/` directory\n- Schema information from the provider, resources, and data sources\n\n\n[tfreg-docs]: https://registry.terraform.io/providers/unikraft-cloud/unikraft-cloud/latest/docs\n\n[tffw-home]: https://developer.hashicorp.com/terraform/plugin/framework\n[tffw-tuto]: https://developer.hashicorp.com/terraform/tutorials/providers-plugin-framework\n[tffw-local]: https://developer.hashicorp.com/terraform/tutorials/providers-plugin-framework/providers-plugin-framework-provider#prepare-terraform-for-local-provider-install\n[tffw-acc]: https://developer.hashicorp.com/terraform/plugin/framework/acctests\n\n[tfplugindocs]: https://github.com/hashicorp/terraform-plugin-docs\n\n[tf-dl]: https://developer.hashicorp.com/terraform/downloads\n[go-dl]: https://go.dev/doc/install\n\n[gotest-flags]: https://pkg.go.dev/cmd/go#hdr-Testing_flags\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Funikraft-cloud%2Fterraform-provider-unikraftcloud","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Funikraft-cloud%2Fterraform-provider-unikraftcloud","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Funikraft-cloud%2Fterraform-provider-unikraftcloud/lists"}