|
| 1 | +--- |
| 2 | +meta: |
| 3 | + title: How to create and manage a Containers namespace |
| 4 | + description: Create, manage, and delete namespaces in Scaleway Serverless Containers. |
| 5 | +content: |
| 6 | + h1: How to create and manage a Containers namespace |
| 7 | + paragraph: Create, manage, and delete namespaces in Scaleway Serverless Containers. |
| 8 | +tags: container namespace manage create delete environment variable secret |
| 9 | +dates: |
| 10 | + validation: 2024-11-14 |
| 11 | + posted: 2021-05-26 |
| 12 | +categories: |
| 13 | + - serverless |
| 14 | + - containers |
| 15 | +--- |
| 16 | + |
| 17 | +This page shows you how to create and manage a Serverless Containers namespace. [Namespaces](/serverless/containers/concepts/#namespace) allow you to group your containers and share environment variables between them. |
| 18 | + |
| 19 | +<Macro id="requirements" /><Macro id="requirements" /> |
| 20 | + |
| 21 | +- A Scaleway account logged into the [console](https://console.scaleway.com) |
| 22 | +- [Owner](/identity-and-access-management/iam/concepts/#owner) status or [IAM permissions](/identity-and-access-management/iam/concepts/#permission) allowing you to perform actions in the intended Organization |
| 23 | + |
| 24 | +## Creating a Serverless Containers namespace |
| 25 | + |
| 26 | +1. Click **Containers** in the **Serverless** section of the side menu. The list of your containers namespaces displays. |
| 27 | +2. Click **Create namespace**. If you have no existing Serverless Containers resources in your current Project, click **Deploy container**. |
| 28 | +3. Complete the following steps in the wizard: |
| 29 | + - Enter a **name**, and optionally a **description** for your namespace. The name must only contain alphanumeric characters and dashes. |
| 30 | + - Choose a **region**, which is the geographical location in which your namespace will be deployed. |
| 31 | + - Enter any **environment variables** required for your namespace. Environment variables configured in a namespace will be available in all containers/apps within the same namespace. For each environment variable, click **+Add new variable** and enter the key / value pair. |
| 32 | + - Set secret environment variables (optional). **Secrets** are environment variables that are injected into your container and stored securely, but not displayed in the console after initial validation. Add a **key** and a **value**. |
| 33 | + - Verify the **estimated cost**. |
| 34 | +4. Click **Create namespace only** to finish, or click **Create namespace and add container** if you want to [deploy a container](/serverless/containers/how-to/deploy-container/) next. |
| 35 | + |
| 36 | +## Managing a Serverless Containers namespace |
| 37 | + |
| 38 | +1. Click **Containers** in the **Serverless** section of the side menu. The containers page displays. |
| 39 | + |
| 40 | +2. Click the containers namespace you want to manage. |
| 41 | + |
| 42 | +3. Click the **Namespace settings** tab. Here, you can view information about the region, registry endpoint and description of your namespace. |
| 43 | + |
| 44 | +4. Add any additional environment variables you wish to add by clicking **+Add**, entering the key/value pair, and clicking **Save**. |
| 45 | + |
| 46 | +5. Add **secrets** for your container. Secrets are environment variables which are injected into your container, but the values are not retained or displayed by Scaleway after initial validation. |
| 47 | + |
| 48 | +## Deleting a Serverless Containers namespace |
| 49 | + |
| 50 | +<Message type="important"> |
| 51 | + - This action will permanently delete your namespace and all your containers will be lost. |
| 52 | + - This action is irreversible. |
| 53 | + - The Container Registry namespace associated with your Serverless Containers namespace will be deleted. |
| 54 | +</Message> |
| 55 | + |
| 56 | +1. Click **Containers** in the **Serverless** section of the side menu. The containers page displays. |
| 57 | + |
| 58 | +2. Click the <Icon name="more" /> icon next to the namespace you want to delete, and select **Delete** from the drop-down menu. |
| 59 | + |
| 60 | +3. Type **DELETE** in the pop-up that asks you to confirm the action, then click **Delete namespace**. |
| 61 | + |
| 62 | +<Message type="tip"> |
| 63 | + You can also delete a namespace from the **Namespace settings** tab. |
| 64 | +</Message> |
0 commit comments