{"id":22653885,"url":"https://github.com/gslabdev/terraform-provider-nsxv","last_synced_at":"2025-04-12T04:06:05.233Z","repository":{"id":96137725,"uuid":"132439740","full_name":"GSLabDev/terraform-provider-nsxv","owner":"GSLabDev","description":"Terraform provider for NSX","archived":false,"fork":false,"pushed_at":"2018-06-06T08:43:32.000Z","size":36,"stargazers_count":5,"open_issues_count":1,"forks_count":2,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-04-12T04:05:49.878Z","etag":null,"topics":["nsx-v","terraform","terraform-provider"],"latest_commit_sha":null,"homepage":"","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/GSLabDev.png","metadata":{"files":{"readme":"README.md","changelog":null,"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":"2018-05-07T09:42:28.000Z","updated_at":"2025-02-05T08:00:27.000Z","dependencies_parsed_at":"2023-07-27T10:00:30.459Z","dependency_job_id":null,"html_url":"https://github.com/GSLabDev/terraform-provider-nsxv","commit_stats":null,"previous_names":["gslabdev/terraform-provider-nsx"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GSLabDev%2Fterraform-provider-nsxv","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GSLabDev%2Fterraform-provider-nsxv/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GSLabDev%2Fterraform-provider-nsxv/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GSLabDev%2Fterraform-provider-nsxv/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GSLabDev","download_url":"https://codeload.github.com/GSLabDev/terraform-provider-nsxv/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248514228,"owners_count":21116903,"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":["nsx-v","terraform","terraform-provider"],"created_at":"2024-12-09T09:30:23.280Z","updated_at":"2025-04-12T04:06:05.223Z","avatar_url":"https://github.com/GSLabDev.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n\n\n# Terraform Vmware NSX Provider\n\nThis is the repository for the Terraform [VMware NSX][1] Provider, which one can use\nwith Terraform to work with VMware NSX.\n\n[1]: https://www.vmware.com/in/products/nsx.html\n\nCoverage is currently only limited to add Virtual Machines to security group in VMware's vSphere NSX.\nWatch this space!\n\nFor general information about Terraform, visit the [official website][3] and the\n[GitHub project page][4].\n\n[3]: https://terraform.io/\n[4]: https://github.com/hashicorp/terraform\n\n# Using the Provider\n\nThe current version of this provider requires Terraform v0.11.7 or higher to\nrun.\n\nNote that you need to run `terraform init` to fetch the provider before\ndeploying. Read about the provider split and other changes to TF v0.11.7 in the\nofficial release announcement found [here][4].\n\n[4]: https://www.hashicorp.com/blog/hashicorp-terraform-0-10/\n\n## Full Provider Documentation\n\nThe provider is useful in adding Virtual Machines to security group in VMware's NSX.\n\n### Example\n```nsx\n# Configure the NSX Provider\nprovider \"nsx\" {\n  nsx_username  = \"${var.nsx_username}\"\n  nsx_password  = \"${var.nsx_password}\"\n  nsx_server_ip = \"${var.nsx_server_ip}\"\n  port          = ${var.nsx_port}\n}\n\n#add virtual machines in the list to the specified security group\nresource \"nsx_add_virtual_machine_security_group\" \"virtualmachine\" {\n \n  cluster_name         = \"Compute Cluster A\"\n  security_group_name  = \"Security Group 1\"\n  domain_id            = \"domain-c242\"\n \n  virtual_machine {\n    name = \"VM1\"\n    id   = \"vm-40\"\n  }\n\n  virtual_machine {\n    name = \"VM2\"\n    id   = \"vm-41\"\n  }\n\n  virtual_machine {\n    name = \"VM3\"\n    id   = \"vm-42\"\n  }\n\n  virtual_machine {\n    name = \"VM4\"\n    id   = \"vm-56\"\n  }\n}\n\n```\n## Checking the Logs\nTo persist logged output you can set TF_LOG_PATH in order to force the log to always be appended to a specific file when logging is enabled. Note that even when TF_LOG_PATH is set, TF_LOG must be set in order for any logging to be enabled.\n\nTo check logs use the following commands\n```sh\nexport TF_LOG=DEBUG\nexport TF_LOG_PATH=/home/terraform-provider-nsx/logs/nsx.log\n```\n\n# Building The Provider\n\n**NOTE:** Unless you are [developing][7] or require a pre-release bugfix or feature,\nyou will want to use the officially released version of the provider (see [the\nsection above][8]).\n\n[7]: #developing-the-provider\n[8]: #using-the-provider\n\n\n## Cloning the Project\n\nFirst, you will want to clone the repository to\n`$GOPATH/src/github.com/terraform-providers/terraform-provider-nsx`:\n\n```sh\nmkdir -p $GOPATH/src/github.com/terraform-providers\ncd $GOPATH/src/github.com/terraform-providers\ngit clone git@github.com:terraform-providers/terraform-provider-nsx\n```\n\n## Running the Build\n\nAfter the clone has been completed, you can enter the provider directory and\nbuild the provider.\n\n```sh\ncd $GOPATH/src/github.com/terraform-providers/terraform-provider-nsx\nmake build\n```\n\n## Installing the Local Plugin\n\nAfter the build is complete, copy the `terraform-provider-nsx` binary into\nthe same path as your `terraform` binary, and re-run `terraform init`.\n\nAfter this, your project-local `.terraform/plugins/ARCH/lock.json` (where `ARCH`\nmatches the architecture of your machine) file should contain a SHA256 sum that\nmatches the local plugin. Run `shasum -a 256` on the binary to verify the values\nmatch.\n\n# Developing the Provider\n\nIf you wish to work on the provider, you'll first need [Go][9] installed on your\nmachine (version 1.9+ is **required**). You'll also need to correctly setup a\n[GOPATH][10], as well as adding `$GOPATH/bin` to your `$PATH`.\n\n[9]: https://golang.org/\n[10]: http://golang.org/doc/code.html#GOPATH\n\nSee [Building the Provider][11] for details on building the provider.\n\n[11]: #building-the-provider\n\n## Configuring Environment Variables\n\nMost of the tests in this provider require a comprehensive list of environment\nvariables to run. See the individual `*_test.go` files in the\n[`nsx/`](nsx/) directory for more details. The next section also\ndescribes how you can manage a configuration file of the test environment\nvariables.\n\n### Using the `.tf-nsx-devrc.mk` file\n\nThe [`tf-nsx-devrc.mk`](tf-nsx-devrc.mk) file contains\nan up-to-date list of environment variables required to run the acceptance\ntests. Copy this to `$HOME/.tf-nsx-devrc.mk` and change the permissions to\nsomething more secure (ie: `chmod 600 $HOME/.tf-nsx-devrc.mk`), and\nconfigure the variables accordingly.\n\n## Running the Acceptance Tests\n\nAfter this is done, you can run the acceptance tests by running:\n\n```sh\n$ make testacc\n```\n\nIf you want to run against a specific set of tests, run `make testacc` with the\n`TESTARGS` parameter containing the run mask as per below:\n\n```sh\nmake testacc TESTARGS=\"-run=TestAccNsx\"\n```\n\nThis following example would run all of the acceptance tests matching\n`TestAccNsx`. Change this for the specific tests you want to\nrun.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgslabdev%2Fterraform-provider-nsxv","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgslabdev%2Fterraform-provider-nsxv","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgslabdev%2Fterraform-provider-nsxv/lists"}