Skip to main content

Getting started

1. Installation​

Download the latest release and select the asset for your operation system.

Also, you can add the location to your es-cli in the environment path to make the CLI available globally if you want.

2. Help options​

If you don't want to go to the documentation every time you are using new commands, you can use the help option to see available commands and options

es-cli -h
Description:

Usage:
  es-cli [command] [options]

Options:
  -v, --verbose      verbose
  --apiKey <apiKey>
  --version          Show version information
  -?, -h, --help     Show help and usage information

Commands:
  login               Login using OAuth
  tenant              Tenant
  environment         Environment
  environment-client  Environment client
  domain              Domain
  source-group        Source group
  source              Source
  views               Generated views
  source-entity       Source entities
  schema              Schemas
  deployment

3. Authentication​

Before you can call any of the commands you must first authenticate. You do that using the login command.

This will open a browser window where you can sign in with your Enterspeed credentials.

es-cli login
info

It's also possible to authenticate using an API key. This is especially useful if you are using the CLI in a pipeline context like CI/CD.

4. Setting the right tenant​

After authenticating the first thing you must do, is to make sure you are working on the right tenant.

To get a list of all available tenants, use the following command.

After that, you can set the tenant using the id from the list.

es-cli tenant set gid://Tenant/5197b4d4-6bdf-4f63-a91b-872905ad1941

5. Cloning schemas from Enterspeed to your local machine​

Now that we have authenticated and selected the right tenant we can start working with the schemas.

tip

You can use the help options for the individual commands as well to get specific help for e.g. the schemas: es-cli schema -h

The schema clone command will clone all the schemas from your tenant to your local machine so you can start working with your schemas locally.

es-cli schema clone

This will create a folder called schemas with all your schemas.

Create source Enterspeed

6. Saving a schema​

Now open up one of your schemas, make a change to the schema and save it. Once you save the schema in your editor, note that the schema is only saved on your local machine.

To save the new changes to your schema in Enterspeed you use the schema save which takes the alias of the schema as an argument, in this case product.

es-cli schema save product

Now if you open up the same schema in Enterspeed you can see the schemas have been updated in Enterspeed.

7. Deploying a schema​

The last step for this guide is to deploy the schema to Enterspeed so that the changes to our schema will be reflected in the views.

To deploy a schema we would need to once again provide the alias of the schema that we want to deploy, and also we would need to provide the environment, that we would deploy our schema to.

es-cli schema deploy product -e "Development"

This was a quick guide to show how to get started and to show just some of the tasks you can do with the CLI.