Terraform Provider HyperCore

This is Terraform Provider for Scale Computing HyperCore product.

Requirements

• Terraform >= 1.0
• Go >= 1.22
• Golangci-lint v1.62.2

Installation

1 Terraform

Follow https://developer.hashicorp.com/terraform/tutorials/aws-get-started/install-cli

For Linux Ubuntu.

wget -O - https://apt.releases.hashicorp.com/gpg | sudo gpg --dearmor -o /usr/share/keyrings/hashicorp-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/hashicorp-archive-keyring.gpg] https://apt.releases.hashicorp.com $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/hashicorp.list
sudo apt update && sudo apt install terraform

For Apple Mac.

# Install brew if it is not yet installed.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install terraform
brew tap hashicorp/tap
brew install hashicorp/tap/terraform
brew update
brew upgrade hashicorp/tap/terraform

Check installation.

terraform --version

2 Go

See https://go.dev/doc/install

For Linux Ubuntu

# download latest version
curl -LO https://go.dev/dl/go1.23.4.linux-amd64.tar.gz

# remove old version and install the new one
sudo rm -rf /usr/local/go && sudo tar -C /usr/local -xzf go1.23.4.linux-amd64.tar.gz

# remove downloaded tar because it's not needed anymore
rm go1.23.4.linux-amd64.tar.gz

# better to add this in your ~/.bashrc
export PATH=$PATH:/usr/local/go/bin

# refresh your shell if needed
source ~/.bashrc

For Apple Mac.

# select the correct one - darwin-arm64.pkg or darwin-amd64.pkg
curl -LO https://go.dev/dl/go1.24.1.darwin-arm64.pkg
curl -LO https://go.dev/dl/go1.24.1.darwin-amd64.pkg
sudo installer -pkg  go1.24.1.darwin-arm64.pkg -target /
# logout/login

Check installation.

go version

3 Golangci-lint

go install github.com/golangci/golangci-lint/cmd/golangci-lint@v1.62.2

# check installation
golangci-lint --version

Building The Provider

1. Clone the repository
2. Enter the repository directory
3. Build the provider using the Go install command:

go install
ls -al $GOPATH/bin/terraform-provider-hypercore $HOME/go/bin/terraform-provider-hypercore  # one of both is the provider binary

Adding Dependencies

This provider uses Go modules. Please see the Go documentation for the most up to date information about using Go modules.

To add a new dependency github.com/author/dependency to your Terraform provider:

go get github.com/author/dependency
go mod tidy

Then commit the changes to go.mod and go.sum.

Using the provider

Fill this in for each provider

Developing the Provider

If you wish to work on the provider, you'll first need Go installed on your machine (see Requirements above).

To compile the provider, run go install. This will build the provider and put the provider binary in the $GOPATH/bin directory.

To generate or update documentation, run make generate.

In order to run the full suite of Acceptance tests, run make testacc.

To install the provider locally to test it out, run make local_provider.

Note: Acceptance tests create real resources, and often cost money to run (this is for aws providers and such).

make testacc

Using the GNUmakefile

❯ make
help                           prints help for targets with comments
all                            format, lint and install (build) the binary and generate docs
build                          build provider
install                        build and install (into $GOPATH)
local_provider                 install provider locally for testing
force_reinit_local             removes autogenerated terraform files from ./local/ and runs 'terraform init'
apply_with_logs                runs TF_LOG=DEBUG terraform apply -auto-approve in ./local/
local_refresh                  runs a Terraform plan with a refresh
run                            run all the targets for a fresh run or re-run (this also removes all terraform cache to ensure a fresh run every time)
lint                           run linter
generate                       generate documentation
fmt                            format the code
test                           run unit tests
testacc                        acceptance tests

Try out the provider with a local installation

# install the provider locally
make install local_provider

# use the main.tf script in ./local
cd local

# create your .env from .env.example and replace with your credentials
cp env.sh.example env.sh
nano env.sh
source env.sh

# init all the providers in main.tf
terraform init

# (optional) check how the resources will be generated
terraform plan

# apply the plan
terraform apply

# you can check the results in terraform.tfstate
cat terraform.tfstate | less

# destroy all resources
terraform destroy

An example env.sh configuration can be found here.

Fresh rerun

make run

Other development notes

See DEVELOPMENT.md.