Managing a Deployment¶

Learn how to list, inspect, access and debug your node deployments.

Assumptions

This assumes you've created a layout in a file named ubuntu.py and you have .env plus Google Authentication completed.

Listing Nodes¶

To list nodes in your deployment, run the following:

bash -c

docker run \
    --env-file .env \
    --rm \
    --volumes-from gcloud-config \
    -v ssh-creds:/root/.ssh \
    -v `pwd`:`pwd` \
    -w `pwd` \
    -it gorambo/ogc:v4 \
    ogc ubuntu.py ls -v

Which gives a table output of current node deployments:

Listing Nodes

Accessing nodes¶

OGC provides a helper command for easily accessing any of the nodes in your deployment.

To login to a node run:

bash -c

docker run \
    --env-file .env \
    --rm \
    --volumes-from gcloud-config \
    -v ssh-creds:/root/.ssh \
    -v `pwd`:`pwd` \
    -w `pwd` \
    -it gorambo/ogc:v4 \
    ogc ubuntu.py ssh -v -o instance_id=123432432

Or

bash -c

docker run \
    --env-file .env \
    --rm \
    --volumes-from gcloud-config \
    -v ssh-creds:/root/.ssh \
    -v `pwd`:`pwd` \
    -w `pwd` \
    -it gorambo/ogc:v4 \
    ogc ubuntu.py ssh -v -o instance_name=ogc-ubuntu-001

Executing commands¶

Running arbitrary commands can be accomplished with:

bash -c

docker run \
    --env-file .env \
    --rm \
    --volumes-from gcloud-config \
    -v ssh-creds:/root/.ssh \
    -v `pwd`:`pwd` \
    -w `pwd` \
    -it gorambo/ogc:v4 \
    ogc ubuntu.py exec -v -o cmd='ls -l /

Executing a scripts directory¶

In addition to running arbitrary commands, OGC can also execute a directory of templates/scripts:

bash -c

docker run \
    --env-file .env \
    --rm \
    --volumes-from gcloud-config \
    -v ssh-creds:/root/.ssh \
    -v `pwd`:`pwd` \
    -w `pwd` \
    -it gorambo/ogc:v4 \
    ogc ubuntu.py exec_scripts -v -o scripts=fixtures/ex_deploy_ubuntu

This can be useful to re-run a deployment or add new functionality/one-offs to a node without disturbing the original layout specifications. Access to the database and all templating is available as well.

Destroying nodes¶

OGC allows destroying of individual or a full blown cleanup. To remove a single node we run:

bash -c

docker run \
    --env-file .env \
    --rm \
    --volumes-from gcloud-config \
    -v ssh-creds:/root/.ssh \
    -v `pwd`:`pwd` \
    -w `pwd` \
    -it gorambo/ogc:v4 \
    ogc ubuntu.py down -v -o instance_name=ogc-ubuntu-001