metal-cli-v0.6.0

The Packet CLI is now the Equinix Metal CLI.

metal init will now configure your token and default project. This saves time when running commands, like metal device list, which previously required the project UUID as an argument. This new config file sets the groundwork for other tools to take advantage of a default token, organization, and project ID. Any common argument, such as metro, device plan, or operating system, can be predefined in the config file.

Some arguments and the config file have changed (now ~/.config/equinix/metal.yaml). ​Notably, use -o json rather than -j, -o yaml rather than -y. ​Inconsistently used flags have been modified for more consistency. Use metal help and metal help [command] for detailed usage arguments.

This is a semver 0.x release. Check with the changelog when updating. More changes (including breaking changes) may be introduced on the way to 1.0.0.

Build the package with go or download the binary for your OS.

Breaking Changes

• #101 The URL of the project and package is now github.com/equinix/metal-cli.
• #124 Package and binary renamed from packet to metal
  ​The default git branch is now main
• #111 short flags have been changed from packet-cli. Check the help for each command.
• #126 METAL_AUTH_TOKEN environment now overrides the config file settings
• #132 Volume support has been removed

Features

• #54 added metal init
  ​defaults can now be set for arguments via config file.
  ​Environment METAL_PROJECT can be used to override the default project (when set).
• #121 added optional --tags for elastic IP request

Improvements

• #150 go/ci/makefile: update to use go 1.16 and fixes on makefile and ci files
• #148 docs: add support page that was referenced but missing
• #149 readme: update table of contents
• #33 Variable scoping is clearer
• #120 dont hide docs,env,completion commands

Thanks go to @cpanato, @jmarhee, @deitch, @mdemeke, @JT804, @desmondpare1, and @eeelijah-333 for helping to prepare and providing feedback on the prereleases leading up to this release.

metal-cli-v0.6.0-alpha3

Changelog

10e9e19 Merge pull request #146 from equinix/id-and-project-id
523e2d7 Merge pull request #148 from cpanato/update-readme
270e31f Merge pull request #149 from cpanato/support-page
6765c61 Merge pull request #150 from cpanato/go116
ab63629 add hack directory to hold tools
b444fd5 avoid argument conflict with default project id
269eb43 ci: update base branch to main
2ffa5ba go: upgrade to use go 1.16
8ccda81 makefile: fix some issues and update golangci-lint
97ef14c prefer device id retrieve argument when project id is also available
e813b74 readme: update table of contents

metal-cli-v0.6.0-alpha2

Changelog

48e16fa Merge pull request #140 from equinix/displague-patch-1
acf96ea Merge pull request #143 from equinix/go-install-version
0a8ef1a Merge pull request #144 from equinix/fix-json
25df3e7 fix -o json which was ignored
cec62e9 fix typo in go get command
8e1d1f8 use go install rather that go get -u for installing via go
666a5c4 use runtime detected version for go install binaries

metal-cli-v0.6.0-alpha1

verifying go-releaser with the renamed project
This tag and release may be removed.

packet-cli-v0.5.0

Changelog

1797a48 Merge pull request #115 from packethost/update-packngo
1bdb63e Merge pull request #119 from packethost/env
e163703 add "packet env" command
19cdc15 fix handling of Facilities without Metros
0f57c3d prefer env var METAL_AUTH_TOKEN to PACKET_TOKEN
3a0ddab update packngo to 0.15.0

packet-cli-v0.4.0

Changelog

234f0c6 add capacity checking for metros (#114)
a397c29 update VLAN "vlan" field to API revised "vxlan" (#112)

packet-cli-v0.3.0

Changelog

10ca3cd add support for metros (#108)

packet-cli-v0.2.0

Changelog

8b4862a Added 'list' alias to get commands (#105)
6abf3ae remove VPN (Doorman) commands, service ended 2021-03-31 (#110)

packet-cli-v0.1.1

Changelog

271f44f Fixed Syntax Highlighting
79d32c2 Merge pull request #95 from nanaboat/go_get_install_method
59f887e Merge pull request #96 from nanaboat/go_get_install_method
2759d28 Merge pull request #97 from displague/packngo-0.5.0
c28459b add "--search" global flag
6f6a4f7 go get installation instructions.

packet-cli-v0.1.0

Packet is now Equinix Metal!, keep an eye on this project for future project and command line name changes.

This release renames Packet name occurrences, URLs, and emails to Equinix Metal.

Breaking Changes

• Updates packet-cli to use packngo-0.4.1
  • https://api.equinix.com/metal/v1 should be permitted in your network policies
  • https://api.packet.net is no longer used
• packet device create no longer takes --storage
  This UUID parameter did not match the API spec (currently undocumented, the details can be found in packngo. The storage field expects a complex structure of disks, raids, and filesystems, not a uuid string).

What's not changing (for now)?

• The command-line tool continues to be named packet, for now.
• The project name (go package URL) continues to carry the packet-cli name, for now.
• PACKET_TOKEN remains the environment variable, for now.
• ~/.packet-cli.yaml / ~/.packet-cli.json remains the configuration file, for now.

When will this change?

In weeks and months to come. Consideration will be made regarding the legacy token and file names. We could continue checking for these names indefinitely, but we could just make a clean break with a binary rename. What about making the token and filename use the binary name? That's sounds too complicated to manage, the binary can already be packet or packet-cli depending on how you installed it.

What will happen to this repo?

Keep an eye out.