Environments

Environments are the named targets a repository deploys to, such as production or staging. The environments view lists them as cards showing each environment's tier, its current deployment, and its health at a glance. Open an environment to see its current deployment, roll back to an earlier one, review its protection rules, and adjust a blue-green traffic split when one is configured.

Where to find it

• URL: the list is at gitvetrix.com/<owner>/<repo>/environments, and a single environment is at gitvetrix.com/<owner>/<repo>/environments/<name>.
• Navigation: open the repository and go to the address above. Select any environment card to open its detail view. The repository's Deployments view also links here from each of its rows.

Browse environments

1. Open the environments view for the repository.
2. Read the cards. Each card is one environment and shows:
   • The environment name.
   • A tier badge — production, staging, development, or preview.
   • A transient chip on a short-lived environment, such as one created for a preview.
   • The short commit ID of the current deployment, or a dash when there is none.
   • A health word summarizing the current deployment's state (see below).
3. Select a card to open that environment.

When the repository has no environments, the view shows No environments configured for this repository yet.

Environment health

The health word on each card comes from the current deployment's state:

• Healthy — the current deployment succeeded.
• Unhealthy — the current deployment failed or errored.
• Deploying — a deployment is queued, pending, or in progress.
• Inactive — the current deployment is no longer serving.
• No deployments yet — nothing has been deployed to this environment.

Read an environment's detail

Open an environment to see its detail view. A breadcrumb at the top links back to Environments, and the heading shows the environment name with its tier badge and, when it applies, a transient chip. The view has these sections:

• Current deployment — the commit ID, ref, and state of the deployment currently serving the environment, or No deployments yet. when there is none.
• Protection rules — the rules that gate deployments to this environment.
• Recent deployments — the most recent deployments to this environment, each with its short commit ID, ref, state, and creation time. It shows No deployments yet. when the environment has never been deployed to.

Roll back the current deployment

When an earlier successful deployment is available to return to, the Current deployment section shows a rollback control.

1. Open the environment.
2. In the Current deployment section, select Rollback to followed by the target commit's short ID.
3. A message confirms Rollback deployment queued. The new deployment then appears in Recent deployments and, once it succeeds, becomes the current deployment.

Manage protection rules

The Protection rules section lists the rules in force for the environment. Each rule shows its name and value:

• Required reviewers — how many reviewers must approve a deployment.
• Wait timer — how long a deployment waits before it can proceed, in minutes.
• Deployment branches — the branches allowed to deploy to the environment.
• Prevent self-review — present when a deployment's own author cannot approve it.

When no rules are set, the section shows No protection rules configured.

To remove a rule:

1. Find the rule in the Protection rules section.
2. Select its Delete control.
3. In the Remove protection rule dialog, confirm by selecting the delete button, which names the rule you are clearing.
4. A message confirms Protection rule removed, and the rule disappears from the list. Other rules are left in place.

Adjust a blue-green traffic split

When an environment has a blue-green target configured, the detail view shows a Blue-green traffic split section. Use it to shift how much traffic goes to the green side.

1. Open the environment.
2. In the Blue-green traffic split section, focus the slider.
3. Move it with the keyboard: the arrow keys change the split by one percent, hold Shift with an arrow key (or use Page Up and Page Down) to change it by ten, and Home and End jump to the ends of the range.
4. The slider announces the current split as a percentage of traffic to blue and to green as you move it. Your change is saved automatically.

Environments without a blue-green target do not show this section.

Related pages

• Deployments — the repository's deployment history across every environment, filterable by environment and status.