This tool allows the manipulation of all Metal Cloud elements via the command line.
Important
Refer to the latest release for the correct package you need to install.
To install on Mac OS X:
brew tap metalsoft-io/homebrew-repo
brew install metalcloud-cli
To install on any CentOS/Redhat Linux distribution:
sudo yum install $(curl -s https://api.github.com/repos/metalsoft-io/metalcloud-cli/releases/latest | grep -i browser_download_url | grep "amd64" | grep -i linux | grep rpm | head -n 1 | cut -d'"' -f4)
To install on any Debian/Ubuntu distributions:
curl -skL $(curl -s https://api.github.com/repos/metalsoft-io/metalcloud-cli/releases/latest | grep -i browser_download_url | grep "$(dpkg --print-architecture)" | grep deb | head -n 1 | cut -d'"' -f4) -o metalcloud-cli.deb && sudo dpkg -i metalcloud-cli.deb
To install on Windows: Binaries are available here:
https://github.com/metalsoft-io/metalcloud-cli/releases/latest
To install using go get (this should also work on Windows):
go get github.com/metalsoft-io/metalcloud-cliIn the Metalcloud's Infrastructure Editor go to the upper left corner and click on your email. Then go to Settings > API & SDKs > API credentials
Copy the api key. It should be of the form :
Configure credentials as environment variables:
export METALCLOUD_API_KEY="<your key>"
export METALCLOUD_ENDPOINT="https://metal.mycompany.com"Use metalcloud-cli help for a list of supported commands.
To create an infrastructure:
metalcloud-cli infrastructure create --label test --datacenter test --return-idmetalcloud-cli infrastructure list
+-------+-----------------------------------------+-------------------------------+-----------+-----------+---------------------+---------------------+
| ID | LABEL | OWNER | REL. | STATUS | CREATED | UPDATED |
+-------+-----------------------------------------+-------------------------------+-----------+-----------+---------------------+---------------------+
| 12345 | complex-demo | d.d@sdd.com | OWNER | active | 2019-03-28T15:23:08Z| 2019-03-28T15:23:08Z|
+-------+-----------------------------------------+-------------------------------+-----------+-----------+---------------------+---------------------+To create an instance array in that infrastructure, get the ID of the infrastructure from above (12345):
metalcloud-cli instance-array create --infra 12345 --label master --proc 1 --proc-core-count 8 --ram 16To view the id of the previously created drive array:
metalcloud-cli instance-array list --infra 12345
+-------+---------------------+---------------------+-----------+
| ID | LABEL | STATUS | INST_CNT |
+-------+---------------------+---------------------+-----------+
| 54321 | master | ordered | 1 |
+-------+---------------------+---------------------+-----------+
Total: 1 Instance ArraysTo create a drive array and attach it to the previous instance array:
metalcloud-cli drive-array create --infra 12345 --label master-da --ia 54321To view the current status of the infrastructure
metalcloud-cli infrastructure get --id 12345
Infrastructures I have access to (as test@test.com)
+-------+----------------+-------------------------------+-----------------------------------------------------------------------+-----------+
| ID | OBJECT_TYPE | LABEL | DETAILS | STATUS |
+-------+----------------+-------------------------------+-----------------------------------------------------------------------+-----------+
| 36791 | InstanceArray | master | 1 instances (16 RAM, 8 cores, 1 disks) | ordered |
| 47398 | DriveArray | master-da | 1 drives - 40.0 GB iscsi_ssd (volume_template:0) attached to: 36791 | ordered |
+-------+----------------+-------------------------------+-----------------------------------------------------------------------+-----------+
Total: 2 elementsApply creates or updates a resource from a file. The supported format is yaml.
metalcloud-cli apply -f resources.yamlThe type of the requested resource needs to be specified using the field kind.
cat resources.yaml
kind: InstanceArray
apiVersion: 1.0
label: my-instance-array
---
kind: Secret
apiVersion: 1.0
name: my-secret
The objects and their fields can be found in the SDK documentation. The fields will be in the format specified in the yaml tag. For example SubnetPool object has a field named subnet_pool_prefix_human_readable in JSON format. In the YAML file used as imput for this command, the field should be called prefix.
The CLI also provides a "condensed format" for most of it's commands:
- instance-array = ia
- drive-array = da
- infrastructure = infra
- list = ls
- delete = rm ...
This allows commands such as:
metalcloud-cli infra lsMost commands also take a label instead of an id as a parameter. For example:
metalcloud-cli infra show --id complex-demoSome commands depend on various permissions. For instance you cannot access another user's infrastructure unless you are a delegate of it.
If the user has the "admin_view" permission, additional commands will be visible.
To enable debugging information in the output set the following environment variable:
export METALCLOUD_LOGGING_ENABLED=trueTo run the unit tests:
go test ./...
To build manually:
go build ./cmd/...
The build process is automated by travis. Just push into the repository using the appropriate tag:
Use git tag to get the last tag:
git tag
v1.6.7
v1.6.8
v1.6.9
v1.7.0
v1.7.1
v1.7.2
v1.7.3
...
v1.7.4
v1.7.5
v1.7.6
v1.7.7
v1.7.8
Push new changes with new tag:
git add .
git commit -m "commit comment"
git tag v1.0.1
git push --tags
A coverage report is generated automatically at each build by coverall. There is a lower limit to the coverage currently set at 20%.
It is a good idea to update the master branch as well (with no tag):
git push
To update the SDK update go.mod file then regenerate the interfaces used for testing.
Ifacemaker is needed
go get ifacemaker
go generate
If new objects are added in the SDK helpers/fix_package.go will need to be updated.
If for some reason you get errors try running the following command manually:
mockgen -source=/Users/alex/code/metal-cloud-sdk-go/metal_cloud_client.go -destination=helpers/mock_client.go
You need mockgen installed.