Deployments

The deployment system manages rolling out application versions to projects in specific environments. With Hydra Deploy, you can deploy and monitor your applications with one click.

Deployment Overview

Go to Deployments in the navigation menu to see an overview of all deployments in your organization.

What you see:

• A list of all deployments
• Filter capabilities (by project, application, environment, user)
• Deployment status
• Timestamp
• The user who performed the deployment

Deployment Statuses:

• Pending - Deployment is in queue
• In Progress - Deployment is being executed
• Success - Deployment completed successfully
• Failed - Deployment failed (check logs for details)

Executing a Deployment

There are multiple ways to execute a deployment:

Method 1: From Project Matrix

1. Go to Projects
2. Select the project
3. Click on an application in the deployment matrix
4. All versions are shown
5. Click on Deploy next to the desired version and environment
6. A confirmation dialog appears
7. Confirm the deployment

Method 2: From Deployment Overview

1. Go to Deployments
2. Click on Deploy
3. Select in the dropdowns:
   • Application - The application you want to deploy
   • Version - The version you want to deploy
   • Project - The target project
   • Environment - The target environment
4. See a deployment summary
5. Confirm to deploy

Method 3: From Deployment History

You can also redeploy earlier deployments:

1. Go to the details of an earlier deployment
2. Click on Redeploy
3. Confirm to redeploy the same deployment

Deployment Details

Click on a deployment to view the details:

General Information:

• Application - Name of the application
• Version - Version number being deployed
• Project - The target project
• Environment - The target environment
• Status - Current status of the deployment
• Triggered By - User who performed the deployment
• Timestamp - When the deployment was started and/or completed

Deployment Logs:

View the output of the deployment script:

• Real-time output (if deployment is still running)
• Full logs (if deployment is completed)
• Error messages (if deployment failed)

Configurations:

View the configuration used for this deployment:

• Base configuration from the application
• Project-specific overrides
• Final result after merge

Deployment Configuration

Before deploying, you can check and adjust the configuration in the confirmation window:

1. Config Editor - View and adjust the configuration
2. Merge Preview - See how base config and overrides are merged
3. Environment Tabs - Switch between different environments

This is useful to check that the correct configuration is used before you deploy.

Deployment Filters

In the deployment overview, you can filter deployments:

Available Filters:

• Triggered By - Filter by user
• Project - Filter by project
• Application - Filter by application
• Environment - Filter by environment

Pagination:

• Navigate through deployment history with pagination
• Set items per page

Deployment Best Practices

Deployment Order

For complex systems, it’s important to deploy in the correct order:

1. Deploy databases and other stateful services first
2. Deploy backend services after
3. Deploy frontends last

Pre-Deployment Checks

• Check if all required agents are online
• Verify that configuration is correct
• Test first in a staging environment

Deployment Monitoring

• Monitor the deployment in real-time
• View the logs after deployment
• Verify that the application is running correctly

Rollback

If a deployment fails:

1. View the logs to identify the problem
2. Deploy a previous, stable version
3. Adjust configuration if needed
4. Deploy again

Deployment Matrix

The deployment matrix provides a visual overview of what is deployed where:

Matrix View:

• Rows: Applications and their versions
• Columns: Environments
• Cells: Deployment status and actions

What you see:

• Which version of each application is running in each environment
• Whether an environment has an agent
• Ability to deploy directly from the matrix

Auto Deploy

See the chapter Auto Deploy Rules for information about automating deployments based on rules.

Deployment History

The deployment history is important for:

• Audit trails - Who deployed what when
• Troubleshooting - Which deployment caused a problem
• Compliance - Proof of deployments and rollbacks
• Planning - Insights into deployment frequency and patterns

Using Deployment History:

1. Go to Deployments
2. Use filters to find specific deployments
3. Click on a deployment to view details
4. View logs, configurations, and result

Failed Deployments

If a deployment fails:

Possible Causes:

• Agent is offline
• Deployment script has errors
• Configuration is invalid
• Server is unreachable
• Missing dependencies

Steps to Resolve:

1. View the deployment logs
2. Identify the error message
3. Fix the problem
4. Redeploy or deploy an earlier version

Real-time Updates

Hydra Deploy uses websockets to provide real-time updates:

• Deployment progress
• Log output
• Status changes

You don’t need to refresh the page to see updates - everything happens automatically.