Create the environment

An Environment is the network and storage resources GENI Workflows needs to run pipelines in a GCP project. The command below registers a new environment in GENI, which in turn uses the credentials you generated to provision those resources in the GCP project.

Note

You must be signed in to GENI Workflows to create resources, as a user of type admin.

geni auth login --email <your-email>

geni environment create \
  --name <env-name> \
  --cloud-provider gcp \
  --cloud-id <project-id> \
  --cloud-region <region> \
  --focus-dataset <project.dataset.table> \
  --focus-location <focus-region> \
  --gcp-credentials gcp-wif.json

Argument	Meaning
<env-name>	A searchable name for the environment, for example Bioinfo Dev
<project-id>	The project’s unique identifier, for example useful-loop-496215-i8
<region>	The region to use, for example us-central1
<project.dataset.table>	The BigQuery FOCUS table — see FOCUS dataset
<focus-region>	The region the FOCUS table lives in
gcp-wif.json	The credentials file written by geni setup enable-gcp

The command creates a deployment named geni-environment and returns a unique environment ID. Keep that ID — engines and queues are attached to the environment by it.

geni environment list

Next

Create an engine.