Skip to main content
Version: Next 🚧

Namespaces

This guide explores working with namespaces. It assumes that Epinio is installed. If you need to install, please visit install Epinio.

Workflow

Once Epinio is deployed, check the existence of the pre-configured namespace workspace with:

epinio namespace list

Output:

🚢  Listing namespaces

✔️ Epinio Namespaces:
| NAME | CREATED | APPLICATIONS | CONFIGURATIONS |
|-----------|-------------------------------|--------------|----------------|
| workspace | 2023-03-14 09:48:11 +0100 CET | | |

Create new namespaces with:

epinio namespace create newnamespace

Output:

🚢  Creating namespace...
Name: newnamespace

✔️ Namespace created.

You can inspect the details of a namespace:

  • creation date
  • applications
  • configurations

Use the command:

epinio namespace show newnamespace

Output:

🚢  Showing namespace...
Name: newnamespace

✔️ Details:
| KEY | VALUE |
|----------------|-------------------------------|
| Name | newnamespace |
| Created | 2023-03-14 15:27:48 +0100 CET |
| Applications | |
| Configurations | |

Epinio creates the default namespace workspace at installation time. The epinio login command sets the default namespace as the current namespace.

To see this use:

epinio target

Output:

✔️  
Currently targeted namespace: workspace

To target the namespace newnamespace, created earlier, for future Epinio command operation:

epinio target newnamespace

Output:

🚢  Targeting namespace...
Name: newnamespace

✔️ Namespace targeted.

Finally, delete the namespace newnamespace:

epinio namespace delete newnamespace  

Output:

You are about to delete namespace workspace and everything it includes, i.e. applications, configurations, etc. Are you sure? (y/n): y

🚢 Deleting namespace...
Name: newnamespace

✔️ Namespace deleted.

See also