Paperspace terraform provider
v0.1.2 -- first release; supports machine and script resources for create/read/destroy/import, and data sources for networks, templates, and users.
Note: currently this provider is offered as a terraform 'private cloud' provider while under early development. We are moving toward contributing it back to the terraform open source project, which will remove the need for a separate download and installation step in the future.
Linux x64 terraform-provider-paperspace
Windows x64 terraform-provider-paperspace.exe
Note: The these downloads were built with go 1.8.3 and tested with terraform 0.9.11
Installation and Testing
- Install terraform and make sure it is in your path.
Note: this release of the Paperspace provider was tested with terraform 0.9.11
Download the Paperspace terraform provider from one of the links above, or build it from source as described below.
Acquire a Paperspace API key for your account. See Paperspace API for instructions on creating an api key.
A sample terraform config file is provided in src/terraform-provider-paperspace/main.tf
Modify this file to use your actual api_key, and valid user email address in the account associated with the api_key.
- cd to the directory where the sample configuration file is located, e.g.:
Make sure the
terraform-provider-paperspaceexecutable is also in your path, or in the directory with the .tf config files you want to use.
Run the following terraform commands interactively to exercise the configuration and examine the output:
(Note the sample configuration will create a machine with a public ip; testing this configuration will result in charges for the machine and public ip resources in most cases.)
terraform plan terraform apply terraform show terraform refresh terraform show terraform plan
- When you are done with testing, run the following to destroy the configuration (and thus destroy the machine and script objects created above):
terraform destroy terraform show
Building from source
- Install the latest version of go
Note: this version of the provider has been successfully compiled with go version 1.8.3
- Clone this repository and change to the project directory
git clone https://github.com/Paperspace/paperspace-terraform.git cd paperspace-terraform
- Set your GOPATH environment variable to the the root of the project, e.g., on Linux:
- Change to the
- Build the Paperspace terraform provider
On Linux x64 run:
On Windows run:
go get go build
The output of the build is a
Note: you cannot execute this provider binary directly. The binary will be loaded by the terraform app if the provider binary is in your path and your .tf configuration files refer to the paperspace provider and paperspace resources, or datasources.
Want to contribute? Contact us at email@example.com