an Application defines how your software is deployed and managed on an Server. It acts as a blueprint for creating and managing Docker containers effectively.
Applications can be:
- Built from source: using a public or private GitHub repository, cloned and built on the target server.
- Deployed from a Docker image: pulled and run directly without source code access.
Each Application includes:
- Labels: Metadata applied to containers for identification, routing, or automation.
- Environment Variables: Key-value pairs passed to containers at runtime.
- Volumes: Persistent storage mounts for container data.
Updating an Application does not automatically redeploy containers. To apply changes, you must manually trigger a redeploy from the Deployment tab.
Creating an Application
To create an Application, follow these steps:
- Navigate to the Applications Page: Click on "Applications" in the sidebar.
- Click "Create Application": This opens the Application creation form.
- Fill in the Details:
- Type: Choose between "Github" (GitHub repository) or "Docker Image".
- Name: Enter a unique name for the Application.
- Domain: Specify the domain for the Application (optional).
- Port: Set the port on which the Application will run (optional).
3a. Github:
- Repository URL: Enter the URL of the GitHub repository.
- Branch: Specify the branch to build from (default is
main
).
3b. Docker Image:
- Image Name: Enter the name of the Docker image to deploy.
- Tag: Specify the image tag (default is
latest
).
- Private Registry: If using a private registry, provide the registry URL and authentication details.
- Configure Labels: Add any labels needed for the Application.
- Set Environment Variables: Add any environment variables required by the Application.
- Define Volumes: Specify any volumes to mount for persistent storage.
- Select Server: Choose the server where the Application will be deployed.