Skip to content

Deploy you cluster with the enabling facility

Before starting be sure to have all the requirements satisfied.

Get your access token

This step should be as simple as:

oidc-token dodas

Setting up dodas client

Create a config file in $HOME/.dodas.yaml:

cloud:
  ## CNAF resources
  id: ost
  type: OpenStack
  host: https://cloud-api-pub.cr.cnaf.infn.it:5000/v3
  username: dodas
  password: <your token here>
  tenant: openid
  auth_version: 3.x_oidc_access_token
  service_region: sdds
  ## RECAS resources
  #id: ost
  #type: OpenStack
  #host: https://cloud.recas.ba.infn.it:5000/
  #username: indigo-dc
  #password: <your token here>
  #tenant: oidc
  #auth_version: 3.x_oidc_access_token
  #service_region: recas-cloud
im:
  id: im
  type: InfrastructureManager
  host: https://im-dodas.cloud.cnaf.infn.it/infrastructures
  token: <your token here>

and fill up the fields needed for you cloud provider.

Download the binary from the latest release on github. For instance:

wget https://github.com/DODAS-TS/dodas-go-client/releases/download/v1.3.0/dodas.zip
unzip dodas.zip
cp dodas /usr/local/bin

Quick start

Let's take Apache Spark deployment on K8s as an example. The template to be used is this. To start your deployment:

dodas create dodas-apps/templates/applications/k8s/template-spark.yaml

The output should be like this:

    validate called
    Template OK
    Template: dodas-apps/templates/applications/k8s/template-spark.yml
    Submitting request to  :  https://im-dodas.cloud.cnaf.infn.it/infrastructures
    InfrastructureID:  9b917c8c-4345-11ea-b524-0242ac150003

To get the infrastructure ID (infID) of all your deployments

dodas list infIDs

And the output should be like this:

    infIDs called
    Submitting request to  :  https://im-dodas.cloud.cnaf.infn.it/infrastructures
    Infrastructure IDs:
    9b917c8c-4345-11ea-b524-0242ac150003
    def0708e-4343-11ea-8e50-0242ac150003

To check the status of the deployment

dodas get status <infID>

And to get the output of the deployment

dodas get output <infID>

And the output should be like this:

status called
Submitting request to  :  https://im-dodas.cloud.cnaf.infn.it/infrastructures
Deployment output:
{"outputs": {"k8s_endpoint": "https://90.147.75.134:30443"}}

Then, to access the k8s dashboard go to https://90.147.75.134:30443 and to access the jupyter notebook go to https://90.147.75.134:30888.

To log into one of the VM created by the deployment:

dodas login <infID> <vmID>
sudo su