Changes to Substrate commands in 2024.01

| Syntax in 2023.12 and earlier | Syntax in 2024.01 and later | Notes | |——————————-|—————————–|——-| | substrate --shell-completion | Bash and Z shell: . <(substrate shell-completion)
Fish: . $(substrate shell-completion \| psub) | Please see Configuring Substrate shell completion and update your shell configuration. | | substrate accounts | substrate account list | | | substrate create-account | substrate account adopt
substrate account create
substrate account update | The three forms of substrate create-account have been split into their own commands for clarity. substrate account create will create and configure the account but exit with an error if the account already exists. substrate account adopt will bring an existing account under Substrate’s management. substrate account update ensures an existing Substrate-managed account is properly configured and then runs Terraform as substrate create-account used to do. | | substrate roles | substrate role list | | | substrate create-role | substrate role create | | | substrate delete-role | substrate role delete | | | substrate terraform | substrate terraform install | | | | substrate terraform | This new form of substrate terraform brings --domain (or -d) and --environment (or -e) to Terraform to simplify selecting the directory in which to run Terraform. For example, substrate terraform --domain www --environment staging --region us-west-2 plan is the same as terraform -chdir=root-modules/www/staging/default/us-west-2 plan. Bonus: Substrate’s autocomplete works for --domain, --environment, --region, etc. and then gives way to Terraform’s autocomplete for init, plan, apply, etc. | | substrate root-modules | substrate terraform root-modules | | | substrate setup-cloudtrail | substrate setup cloudtrail | | | substrate setup-debugger | substrate setup debugger | | | substrate delete-static-access-keys | substrate setup delete-static-access-keys | |

In addition to these changes, Substrate 2024.01 switched to the POSIX standard of using two dashes to prefix long option names, i.e. -domain becomes --domain, etc.

Pass the --help option to any Substrate command to see the full details.