Serverless Containers — Configuration & Environment Variables
This guide explains how configuration and environment variables work for Serverless Container applications in CloudRaya.
It focuses on how CloudRaya exposes a container-level configuration layer, how multi-container applications are handled, and which changes trigger a redeploy of the application runtime.
Configuration as a Runtime Layer
In CloudRaya, configuration is applied at the container runtime level, not at the infrastructure level.
Each Serverless Container application may consist of:
- A primary application container (for example, a web service)
- One or more supporting containers (for example, a database or background worker)
Environment variables act as the interface between your configuration and the running containers.
Default Environment Variables
When you deploy an application, CloudRaya automatically injects a set of default environment variables based on the selected application template.
Examples:
- Web applications may receive database connection variables
- CMS platforms may receive application keys or base URLs
- Database containers may receive user and password variables
These defaults are designed to make the application functional immediately after deployment.
You can view these variables in the Environment tab of the application detail page.
Multi-Container Awareness
Some Serverless Container applications run more than one container.
Examples include:
- A web container and a database container
- A main service and a background worker
In the Environment tab, you can:
- Select which container you want to configure
- View and edit variables that apply only to that container
This allows you to manage configuration per container, not just per application.
Adding and Updating Variables
Adding a Variable
- Open Marketplace → My Apps
- Click your application
- Open the Environment tab
- Select the target container
- Click + Add Variable
- Enter the variable name and value
- Click Update & Deploy
Updating a Variable
- Select the container
- Edit the variable value
- Click Update & Deploy
Changes are not applied immediately. They are staged and then applied during a redeploy process.
What Triggers a Redeploy
A redeploy rebuilds the application runtime using the same application template, package size, and configuration, but with updated settings.
The following actions trigger a redeploy:
- Adding or updating environment variables
- Changing container-level configuration
- Resizing the application package
- Updating domain or routing configuration
During a redeploy:
- The application may temporarily enter a Terminating or Deploying state
- Containers are recreated with the new configuration
- The public endpoint remains the same
Secrets and Sensitive Values
Environment variables often contain sensitive information, such as:
- Database passwords
- API keys
- Application secrets
Best Practices
- Do not store secrets in plain text documents or code repositories
- Limit access to the Environment tab to trusted users
- Rotate secrets regularly
- Use strong, unique values for credentials
CloudRaya secures the underlying platform, but you are responsible for the values you store in your application configuration.
Configuration Scope
Each application can run one or more containers.
When you add an environment variable, you choose where it applies. Always check which container is selected before saving changes, so the variable is applied to the correct part of your application.
Responsibility Model
In general:
- CloudRaya is responsible for:
- Infrastructure and container platform
- Runtime availability
- You are responsible for:
- Environment variable values
- Application configuration logic
- Protecting sensitive information
Next Guide
Learn how to observe application health, stream container logs, and troubleshoot runtime issues using CloudRaya’s observability tools.