Skip to main content Link Search Menu Expand Document (external link)

Environments

Your account can be associated with multiple environments considering the following restrictions:

  • Only account administrators can create or delete environments.
  • An environment quota is limited by the account available quota.

For more information, check common use cases for environments.

List your environments

Obtain a list of all your available environments executing:

playground env list
Current environment: account1/env1
CURRENT    ACCOUNT     NAME        ID           DESCRIPTION
*          account1    env1        <env1_id>    description environment 1
           account1    env2        <env2_id>    description environment 2
           account2    env3        <env3_id>    description environment 3

or list only the environments of one account:

playground env list account1 
Current environment: account1/env1
CURRENT    ACCOUNT     NAME        ID           DESCRIPTION
*          account1    env1        <env1_id>    description environment 1
           account1    env2        <env2_id>    description environment 2

Check the environment info

Get the environment detailed information executing:

playground env info <account>/<environment>
Server version: v1.20.9-gke.1001 OAM: v0.2.1
CREATION_TIME                           CREATED_BY
2021-09-01 16:03:48.452752 +0000 UTC    <username>

ACCOUNT    ENV              CPU     RAM       STORAGE
<account>  <environment>    0/1     0/4000    0/1000

DESCRIPTION
environment description

Create environments

As administrator of an account, you can create new environments in the account.

playground env create <account_name>/<env_name> \
 --description=”This is a test--cpu=1 --ram=2G --storage=5G --set-as-default=true
Flags:
      --cpu float32          Cpu quota
      --description string   Environment description
      --ram string           Ram quota
      --set-as-default       Set environment as default
      --storage string       Storage quota

If the quota is not indicated (cpu, ram and/or storage), the environment will be created with the default quota associated with your subscription plan. You may create many environments to accommodate your specific use case, but the number of maximum environments is limited by the subscription plan. If you need more environments, consider upgrading your subscription plan, or contact us for special requests.

If the environments that is created requires more quota than available, the following error will be shown:

rpc error: code = Internal desc = Error creating environment. Not enough resources available

Select active environment

An application can be deployed in any of the environments you have access even if those belong to multiple accounts. When the login operation is performed, your credentials will allow you access to your default environment. To work in another environment, you will need to either use the --env argument when supported, or change manually to another environment with the use command.

playground env use <account1>/<env2>
Logged into account [account1] - environment [env2]

To check which is the environment currently in use in the given session, execute a list operation and check for which environment is marked in use.

playground env list
Current environment: account1/env1
CURRENT    ACCOUNT       NAME          ID           DESCRIPTION
           <account1>    <env1>        <env1_id>    <description environment 1>
*          <account1>    <env2 >       <env2_id>    <description environment 2>
           <account2>    <env3>        <env3_id>    <description environment 3>