{"id":39945434,"url":"https://github.com/xenserver/terraform-provider-xenserver","last_synced_at":"2026-01-18T19:47:52.140Z","repository":{"id":171912300,"uuid":"648572792","full_name":"xenserver/terraform-provider-xenserver","owner":"xenserver","description":"XenServer provider for Terraform","archived":false,"fork":false,"pushed_at":"2025-09-23T07:25:00.000Z","size":8571,"stargazers_count":20,"open_issues_count":5,"forks_count":7,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-09-23T09:22:24.540Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xenserver.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-06-02T09:31:33.000Z","updated_at":"2025-09-23T07:25:04.000Z","dependencies_parsed_at":null,"dependency_job_id":"c9e41e33-d4b9-4774-a9f9-bf472b03dbb8","html_url":"https://github.com/xenserver/terraform-provider-xenserver","commit_stats":null,"previous_names":["xenserver/terraform-provider-xenserver"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/xenserver/terraform-provider-xenserver","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xenserver%2Fterraform-provider-xenserver","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xenserver%2Fterraform-provider-xenserver/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xenserver%2Fterraform-provider-xenserver/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xenserver%2Fterraform-provider-xenserver/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xenserver","download_url":"https://codeload.github.com/xenserver/terraform-provider-xenserver/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xenserver%2Fterraform-provider-xenserver/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28549722,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-18T19:22:41.102Z","status":"ssl_error","status_checked_at":"2026-01-18T19:22:26.310Z","response_time":98,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":[],"created_at":"2026-01-18T19:47:51.629Z","updated_at":"2026-01-18T19:47:52.126Z","avatar_url":"https://github.com/xenserver.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Terraform Provider XenServer\nThis repository is the [Terraform Provider of XenServer](https://registry.terraform.io/providers/xenserver/xenserver/latest/docs), using the [Terraform Plugin Framework](https://developer.hashicorp.com/terraform/tutorials/providers-plugin-framework), containing:\n\n- `docs/`      The generated documentation.\n- `examples/`  The examples of provider, resources and data sources.\n- `tools/`     The tool files, like generate document tool.\n- `xenserver/` The provider, resources, data sources and tests.\n- Miscellaneous meta files.\n\n## Developing the Provider\n### Requirements\n\n- [Terraform](https://developer.hashicorp.com/terraform/downloads) \u003e= 1.8\n- [Go](https://golang.org/doc/install) (see the go version in go.mod)\n\n\n### Prepare Development Environment\n\nThe following instructions are based on Linux system.\n\n- Prepare the local XenServer SDK module\n    - [Download](https://www.xenserver.com/downloads) the XenServer SDK zip package and unzip\n    - Create `goSDK/` directory under `terraform-provider-xenserver/`\n    - Copy all source files under `XenServer-SDK/XenServerGo/src/` to `terraform-provider-xenserver/goSDK/` folder\n\n### Build\n\nRun the commands as follows:\n```shell\ngo get -u all\ngo mod tidy\n```\n\nTo compile the provider, run `\"go install\"`. This will build the provider and put the provider binary in the `$GOPATH/bin` directory.\n\nIn short, you can just run `make provider` instead.\n\n### Document\n\nTo generate or update documentation, run `make doc`.\n\n### Log\n\nSet up log with `github.com/hashicorp/terraform-plugin-log/tflog`. To enable logging during local developing run:\n\n```shell\nexport TF_LOG_PROVIDER=\"DEBUG\"\nexport TF_LOG_PATH=/tmp/terraform.log\n```\n\nFind more details in [Managing Log Output](https://developer.hashicorp.com/terraform/plugin/log/managing).\n\n### Acceptance Test\nIn order to run the full suite of acceptance tests, prepare a local `.env` file like:\n\n```shell\nexport XENSERVER_HOST=https://\u003cxenserver-host-ip\u003e\nexport XENSERVER_USERNAME=\u003cusername\u003e\nexport XENSERVER_PASSWORD=\u003cpassword\u003e\nexport NFS_SERVER=\u003cnfs-server-ip\u003e\nexport NFS_SERVER_PATH=\u003cnfs-server-path\u003e\nexport SMB_SERVER_PATH=\u003csmb-server-path\u003e\nexport SMB_SERVER_USERNAME=\u003csmb-server-username\u003e\nexport SMB_SERVER_PASSWORD=\u003csmb-server-password\u003e\nexport SUPPORTER_HOST=\u003csupporter-ip\u003e\nexport SUPPORTER_USERNAME=\u003csupporter-username\u003e\nexport SUPPORTER_PASSWORD=\u003csupporter-password\u003e\n```\n\nRun `\"make testacc\"`. *Note:* Acceptance tests generate actual resources and frequently incur costs when run.\n\n```shell\nmake testacc\n```\n\n## Prepare Terraform for local provider install\n\nTerraform allows to use local provider builds by setting a `dev_overrides` block in a configuration file called `.terraformrc`. This block overrides all other configured installation methods.\n\n1. Set `GOBIN` to the path where Go installs binaries or use the default path:\n\n```shell\nexport GOBIN=$HOME/go/bin\ngo env GOBIN\n```\n\n2. Create a new file called `.terraformrc` in home directory (~). Change the \u003cPATH\u003e to the value returned from the go env `GOBIN` command above.\n\n```shell\nprovider_installation {\n  dev_overrides {\n      \"registry.terraform.io/xenserver/xenserver\" = \"\u003cPATH\u003e\"\n  }\n  direct {}\n}\n```\n\n3. To compile the provider, run `\"go install .\"`. This will build the provider and put the provider binary in the \u003cGOBIN\u003e directory.\n\n4. Local test with terraform command, you'll first need Terraform installed on your machine (see [Requirements](#requirements) above). Go to `examples/terraform-main/` folder, update the `main.tf` with your own configuration, then run terraform commands like:\n\n```shell\nterraform plan\nterraform apply -auto-approve\n\n// show state\nterraform state show xenserver_vm.vm\n\n// remove state\nterraform state rm xenserver_vm.vm\n\n// import state with uuid\nterraform import xenserver_vm.vm \u003cxenserver_vm.vm.uuid\u003e\nterraform show\n\n// change resource.tf data and re-apply\nterraform apply -auto-approve\n\nterraform destroy -auto-approve\n```\n\n5. Local Run Go lint check:\n\n```shell\ngofmt -w -l xenserver/*.go\nsudo docker run -it -v $(pwd):/app -w /app golangci/golangci-lint bash\ngolangci-lint run --config=/app/.golangci.yml\n```\n\n## Known Issue\n1. If you are using Terraform provider v0.1.1, you might encounter compatibility issues after applying the XenServer 8 updates released to Early Access on 25 September 2024 and Normal on 2 October 2024. Terraform v0.1.2 resolves these compatibility issues.\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md)\n\n## License\n\nSee [LICENSE.md](LICENSE.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxenserver%2Fterraform-provider-xenserver","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxenserver%2Fterraform-provider-xenserver","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxenserver%2Fterraform-provider-xenserver/lists"}