Get data-container

Overview

You can review your Data Container by using the get command.

Commands

$ spawnctl get data-containers

$ spawnctl get data-container <ContainerName_Or_ContainerID>

You can change the output format when getting data containers to return more information. -o json will print the data container information out as JSON, including connection details (hostname, port, username, password). This makes it easier to consume Spawn as part of a startup script for an application as you can dynamically configure database connection details.

$ spawnctl get data-container <ContainerName_Or_ContainerID> -o json

Tutorial

In this tutorial we will create a Data Image, then create a Data Container from that image. We will then review the Data Container information.

As a prerequisite you should've followed the instructions to install spawnctl

Create a file development.yaml with your Data Image specifications.
```
sourceType: empty
name: dev
engine: postgresql
```
In this case we want to create a PostgreSQL Data Image that is completely empty and is named dev.

Run the following command to create a Data Image.

$ spawnctl create data-image -f ./development.yaml
Data image 'dev' created!

Create a Data Container from the newly created Data Image.

$ spawnctl create data-container --image dev
Data container 'dev-rambbomj' created!
-> Host=instances.spawn.cc;Port=53223;User ID=<some_user_id>;Password=<some_password>;

You can verify your Data Container was properly created by running the following command.

$ spawnctl get data-containers
NAME          CONTAINER ID  REVISION  STATUS  MESSAGE  ENGINE      CREATED
dev-rambbomj  10001         rev.0     2       Running  PostgreSQL  1 minute ago

You can also get only that specific container.

$ spawnctl get data-container dev-rambbomj
NAME          CONTAINER ID  REVISION  STATUS  ENGINE      MESSAGE  CREATED
dev-rambbomj  10005         rev.0     2       PostgreSQL  Running  11 seconds ago