As an EWC user, I want to deploy an hub item in my tenancy.

1. Login to OpenStack Horizon

• User logs into Horizon using their EWC IAM credentials. EWC Cloud Management UI - Accessing the Horizon portal

The user can access the OpenStack Horizon and can see the project and resources.

2. Create OpenStack Application Credentials

• User logs into Horizon using their EWC IAM credentials. EWC Cloud Management UI - Identity - Create Application Credentials

The user saves the OpenStack Application Credentials ID and Secret safely.

3. Install ewccli (linux machines)

• User installs in their laptop, or a machine they want to use to manage the machines in the cloud, the ewccli locally: pip install ewccli or uv add ewccli (depends on the preferred python dependency manager and python environment manager)

The ewccli is correctly installed. You can run ewc and verify everything works fine if you see:

4. Login with the ewccli

• User logins with the ewccli: ewc login interactively. providing

  • tenancy name
  • federee (EUMETSAT or ECMWF)
  • region (ECIS-R1|R2 for EUMETSAT and CC1|CC2 for ECMWF)
  • SSH keys (created automatically with the ewccli and stored under ~/.ewccli/.ssh/
    • NOTE: if you want to use your own SSH keys, you can use the follosing flags in the ewc login command --ssh-private-key-path   (Path to SSH private key) and --ssh-public-key-path  (Path to SSH public key.) 
  • OpenStack Application Credential ID
  • OpenStack Application Credential Secret

The ewc login correctly ends and the profile is created in ~/.ewccli/profiles. You can check the name of your profiles in that file, for example:

5. List Hub item

• User lists the deployable items

  ewc hub list

6. Deploy an Hub Item from the list

• User deploy an Hub Item from the list (e.g. ssh-bastion)

  ewc hub deploy --profile PROFILE HUB_ITEM

  where you have to setup:
  • PROFILE  is the name of the profile (see login step above)
  • HUB_ITEM is the name of the item as taken by ewc hub list command (e.g.  ssh-bastion-flavour)
  • --server-name SERVER_NAME flag where you pass the name of the VM of the hub item. NOTE: By default if you don't provide --server-name during a deployment of an item, the name of the VM will be the same as the hub item name. If a VM with that name exists, the ewccli will perform the command on that specific VM.
  • OPTIONAL: --flavour-name can be used to customize the resources of the hub item, please check EWC VM plans - European Weather Cloud Knowledge Base
  • for other options to pass to the command please check ewc hub deploy --help