terra-farm / terraform-provider-virtualbox

VirtualBox provider for Terraform
https://terra-farm.github.io/provider-virtualbox/
MIT License
323 stars 134 forks source link

No Valid Documentaiton #87

Closed ghost closed 4 years ago

ghost commented 4 years ago

I guess you already had guy suggesting this, but realy: you need to write down how you to use your piece of software. I've been on this for few hours already and can't make it work.

ringods commented 4 years ago

Fair point, but an Open Source project only lives by the various contributions of it's users. Any contributions welcome!

ghost commented 4 years ago

i'd love to contribute - please guide me to basic main.tf file and i'll add README.md with something. this is what i am getting after compiling and placing the plugin at ~/.terraform.d/plugins folder:

terraform  init

Initializing the backend...

Initializing provider plugins...
- Checking for available provider plugins...

Provider "virtualbox" not available for installation.

A provider named "virtualbox" could not be found in the Terraform Registry.

This may result from mistyping the provider name, or the given provider may
be a third-party provider that cannot be installed automatically.

In the latter case, the plugin must be installed manually by locating and
downloading a suitable distribution package and placing the plugin's executable
file in the following directory:
    terraform.d/plugins/linux_amd64

Terraform detects necessary plugins by inspecting the configuration and state.
To view the provider versions requested by each module, run
"terraform providers".

Error: no provider exists with the given name

these are the errors that i am getting.

terraform plan

Error: Could not satisfy plugin requirements

Plugin reinitialization required. Please run "terraform init".

Plugins are external binaries that Terraform uses to access and manipulate
resources. The configuration provided requires plugins which can't be located,
don't satisfy the version constraints, or are otherwise incompatible.

Terraform automatically discovers provider requirements from your
configuration, including providers used in child modules. To see the
requirements and constraints from each module, run "terraform providers".

Error: provider.virtualbox: no suitable version installed
  version requirements: "(any version)"
  versions installed: none

here is the compiled file in dedicated folder as shown at your documentation.

ls -la ~/.terraform.d/plugins/linux_amd64/terraform-provider-virtualbox/
total 120
drwxrwxr-x. 8 que que  4096 Jan 22 11:01 .
drwxrwxr-x. 3 que que  4096 Jan 22 11:20 ..
-rw-rw-r--. 1 que que   159 Jan 22 11:01 antora.yml
-rw-rw-r--. 1 que que   980 Jan 22 11:01 CHANGELOG.md
-rw-rw-r--. 1 que que    54 Jan 22 11:01 codecov.yml
-rw-rw-r--. 1 que que  1801 Jan 22 11:01 CONTRIBUTING.md
drwxrwxr-x. 2 que que  4096 Jan 22 11:01 examples
drwxrwxr-x. 8 que que  4096 Jan 22 11:01 .git
-rw-rw-r--. 1 que que    30 Jan 22 11:01 .gitattibutes
drwxrwxr-x. 3 que que  4096 Jan 22 11:01 .github
-rw-rw-r--. 1 que que   329 Jan 22 11:01 .gitignore
-rw-rw-r--. 1 que que   528 Jan 22 11:01 gogetcookie.sh.enc
-rw-rw-r--. 1 que que   545 Jan 22 11:01 go.mod
-rw-rw-r--. 1 que que 32202 Jan 22 11:01 go.sum
-rw-rw-r--. 1 que que  1065 Jan 22 11:01 LICENSE
-rw-rw-r--. 1 que que   436 Jan 22 11:01 main.go
-rw-rw-r--. 1 que que    13 Jan 22 11:01 main_test.go
-rw-rw-r--. 1 que que  1001 Jan 22 11:01 Makefile
drwxrwxr-x. 4 que que  4096 Jan 22 11:01 modules
-rw-rw-r--. 1 que que  1834 Jan 22 11:01 README.md
drwxrwxr-x. 2 que que  4096 Jan 22 11:01 scripts
-rw-rw-r--. 1 que que  1924 Jan 22 11:01 .travis.yml
drwxrwxr-x. 3 que que  4096 Jan 22 11:01 virtualbox
ghost commented 4 years ago

i'll just wait till the terrform registry deploy

ringods commented 4 years ago

@silent-mobius I have given the website a make over. Is the navigation better now? If not, please file an issue with your recommendations in the repository for the website:

https://github.com/terra-farm/terra-farm.github.io/issues

ghost commented 4 years ago

i'd suggest to point out on the site that plugin is at release tab it could be good practice to have install script, in python or bash to make the deploy easy. btw, i was able to make it work eventually, but i am guessing that project isn't ready for mass use, and as mentioned, i'll wait till you deploy to registry.