There's an upcoming change in ECE 2.5.0 which will remove the ability to create deployments specifying a
custom topology and only allow the creation of deployments which have a deployment_template_id present
in the create request. Tying that with the fact that deployment templates might specify required resources
like Kibana or APM to be included on creation, it means
thus the ecctl deployment elasticsearch create command has been removed

Notable changes

Migrated creation of Kibana and APM resources to the Deployments API

Migrated all of the creation endpoints to the deployments API.

Version output has been extended

ecctl version returns much more information:

$ ecctl version
Version:               1.0.0-beta1
Client API Version:    2.4.2
Go version:            go1.13.5
Git commit:            4fcde59a
Built:                 Fri 20 Dec 05:58:12 2019
OS/Arch:               darwin / amd64

--track flag is available for most commands which incur deployment plan changes

Added resource change tracking capabilities to:

deployment create
deployment update
deployment shutdown

--override-failsafe is now available on vacate operations

Added an --override-failsafe flag to ecctl platform allocator vacate, which cause the Elastic Cloud
to accept changes even when believed to lead to data loss. Use with caution.

New Commands

Added all deployment commands

Added all the missing commands which implement their API counterpart:

ecctl deployment create Creates a deployment from a file definition, allowing certain flag overrides
ecctl deployment delete Deletes a previously stopped deployment from the platform
ecctl deployment list Lists the platform's deployments
ecctl deployment restore Restores a previously shut down deployment and all of its associated sub-resources
ecctl deployment search Performs advanced deployment search using the Elasticsearch Query DSL
ecctl deployment shutdown Shuts down a deployment and all of its associated sub-resources
ecctl deployment upgrade Updates a deployment from a file definition, allowing certain flag overrides

Added a plan cancel for the deployment resources

ecctl deployment plan cancel

Added all deployment resource commands

Added all the deployment resource actions which are available in the API:

ecctl deployment resource delete Deletes a previously shut down deployment resource
ecctl deployment resource restore Restores a previously shut down deployment resource
ecctl deployment resource shutdown Shuts down a deployment resource by its type and ref-id
ecctl deployment resource start Starts a previously stopped deployment resource
ecctl deployment resource start-maintenance Starts maintenance mode on a deployment resource
ecctl deployment resource stop Stops a deployment resource
ecctl deployment resource stop-maintenance Stops maintenance mode on a deployment resource
ecctl deployment resource upgrade Upgrades a deployment resource

Added elasticsearch keystore commands

Manages an Elasticsearch cluster's keystore

set Updates an Elasticsearch cluster keystore with the contents of a file
show Shows an Elasticsearch cluster's keystore settings

Bug fixes

init command now skips tls validation

It was reported that in some instances ecctl init would return with an error even after providing valid
credentials, this was mainly due to ecctl performing TLS validation where a lot of ECE installations have
self signed certificates. It now will skip TLS Verification by default.

init command now writes the JSON config without returning an error

The default directory for configuration (~/.ecctl) was oftentimes not created in the machine where the
command was being run, which caused the configuration to not be written to that folder. This has been fixed.

--timeout flag is now honored

Using the --timeout global flag now has the desired effect in any of the commands, where before a static 30s
timeout was used from the default transport even when http.Client.Timeout being overriden.

Unexpected errors are now unpacked instead of returning "unknown error (status xxx)"

Leverages the new unwrapping capabilites of api.UnwapError which now unwraps the API errors which previously
were returned as unknown error (status xxx).

Fix broken "user key show" command

The command was broken since the UserID wasn't specified and the Key ID was being set instead of the User ID.
The command now works as expected.

Docs

Added ASCIIDoc for commands

Added auto-completion instructions to the docs

Detailed changes

97c3985 Adding ecctl icon to repo (#111)
a752cec Fix command wording (#108)
5939798 stack: Skip returning an error on packed __MACOSX (#105)
0f5a632 elasticsearch: Fix broken diagnostics command (#110)
4945fbb cmd: Add default region to APM and Kibana create (#109)
398bf99 cmd: Remove newer version check on ecctl version (#103)
4fcde59 Add auto completion intruction to docs (#101)
f3d653a user: Fix key show command (#106)
f8eb428 Convert command reference files to Asciidoctor (#61)
997c7e2 fix refid discovery and require confirmation (#104)
99b8d28 Update ecctl-getting-started.asciidoc (#102)
0b30073 Add timeout values to ecctl.Config (#100)
35bcb95 dep: update cloud-sdk-go to v1.0.0-bc9 (#98)
67baf3d go.sum: Update hashes to the latest version (#97)
ce54eda cmd: Add ref-id auto-discovery to resource upgrade (#92)
f3d09b3 cmd: update resource params to use common struct (#96)
7c2be04 cmd: Add deployment resource delete command (#88)
bd7c910 Version: Change to v1.0.0-beta1 (#94)
1579791 cmd: Add deployment resource restore command (#87)
706b480 cmd: add deployment resource start/start-maintenance commands (#89)
033f06d cmd: Add deployment resource stop and stop-maintenance cmds (#81)
d2c27b5 cmd: Add deployment resource shutdown command (#86)
dbad10d cmd: Remove elasticsearch create (#93)
d4ee664 build(deps): bump github.com/go-openapi/runtime from 0.19.8 to 0.19.9 (#85)
c56296c build(deps): bump github.com/go-openapi/strfmt from 0.19.3 to 0.19.4 (#84)
e642e41 cmd: Add --track flag to deployment commands (#80)
c66d3bf cmd: Migrate apm create to deployments API (#79)
bd75994 Support vacate override failsafe (#82)
73c0fac cmd: Add deployment resource upgrade command (#76)
d1409c8 build(deps): bump github.com/spf13/viper from 1.5.0 to 1.6.1 (#75)
aaa5d87 cmd: Migrate kibana create to deployments API (#71)
88c7938 cmd: Add deployment plan cancel (#72)
520dbf8 docs: Remove tap pin step from brew instructions (#70)
ea03569 cmd: Move elasticsearch create to deployment API (#67)
ce9bbdd Remove ErrCatchTransport from default http client (#66)
a318a5f cmd: Fix init command on unexisting .ecctl folder (#64)
8dcfa6e deployment: Fix show resource type command (#57)
841ddef elasticsearch: Add keystore management commands (#58)
72fc278 http: Add api.DefaultTransport in http.Client (#59)
21176cd deployment: Add update command (#55)
143ffe5 init: Remove mentions of ESS in config bootstrap (#54)
c0ae026 docs: Remove region mentions (#50)
7d63ff8 version: Extend output to include ECE API Version (#53)
8d72808 init: Ensure homepath is created (#51)
a4eb0ac docs: Change the term Kibana Cluster to instance (#49)
78dd825 go.mod: Update cloud-sdk-go to version v1.0.0-bc4 (#48)
7ba34cc remove plural aliases and update docs (#47)
d05811e init: Skips TLS validation on API calls (#39)
1bd7726 deployment: Add restore command (#38)
b32c889 deployment: Add create command (#36)
f1c5258 deployment: Add delete command (#35)
912f410 build(deps): bump github.com/spf13/viper from 1.4.0 to 1.5.0 (#24)
93444fd build(deps): bump github.com/go-openapi/runtime from 0.19.7 to 0.19.8 (#33)
fb7681b deployment: Add search command (#34)
ee092c6 deployment: Add shutdown command (#32)
a01959c deployment: Add list command (#30)
df2d729 Add CONTIBUTING note about GitHub Actions in Forks (#29)
eade2fb Bump Go version to 1.13 (#31)
3a3c81f Beta doc updates (#23)
d994fa4 Improve user documentation (#22)
7d10b3e trivial: fixes various typos (#19)
ad77c57 trivial: bump golanci version to 1.21 (#20)
ddafa35 ci: run go build action in PRs (#21)
3b1b1ef Convert the ecctl docs to Asciidoctor (#7)
0472113 ci: remove uneccesary gh info (#16)

Assets 2

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Changelog

Release notes

Changelog

Release notes

Release notes

Changelog

Breaking changes

Remove pluralized list commands

Removed deployment elasticsearch create command

Notable changes

Migrated creation of Kibana and APM resources to the Deployments API

Version output has been extended

--track flag is available for most commands which incur deployment plan changes

--override-failsafe is now available on vacate operations

New Commands

Added all deployment commands

Added a plan cancel for the deployment resources

Added all deployment resource commands

Added elasticsearch keystore commands

Bug fixes

init command now skips tls validation

init command now writes the JSON config without returning an error

--timeout flag is now honored

Unexpected errors are now unpacked instead of returning "unknown error (status xxx)"

Fix broken "user key show" command

Docs

Added ASCIIDoc for commands

Added auto-completion instructions to the docs

Detailed changes

Releases: elastic/ecctl

v1.0.0

Changelog

Release notes

v1.0.0-beta3

Changelog

Release notes

v1.0.0-beta2 (ECE 2.5.0)

Release notes

v1.0.0-beta1 (ECE 2.4.x)

Changelog

Breaking changes

Remove pluralized list commands

Removed deployment elasticsearch create command

Notable changes

Migrated creation of Kibana and APM resources to the Deployments API

Version output has been extended

--track flag is available for most commands which incur deployment plan changes

--override-failsafe is now available on vacate operations

New Commands

Added all deployment commands

Added a plan cancel for the deployment resources

Added all deployment resource commands

Added elasticsearch keystore commands

Bug fixes

init command now skips tls validation

init command now writes the JSON config without returning an error

--timeout flag is now honored

Unexpected errors are now unpacked instead of returning "unknown error (status xxx)"

Fix broken "user key show" command

Docs

Added ASCIIDoc for commands

Added auto-completion instructions to the docs

Detailed changes