gitlab-org--gitlab-foss/doc/topics/autodevops/index.md

stage	group	info
Configure	Configure	To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments

Auto DevOps (FREE)

• Introduced in GitLab 11.0.
• Support for the GitLab agent was introduced in GitLab 14.5.

GitLab Auto DevOps is a collection of pre-configured features and integrations that work together to support your software delivery process.

Auto DevOps detects your programming language and uses CI/CD templates to create and run default pipelines to build and test your application. Then, you can configure deployments to deploy your apps to staging and production, and set up Review Apps to preview your changes per branch.

You can use default settings to quickly ship your apps, and iterate and customize later.

You can also manage Auto DevOps with APIs.

For an introduction to Auto DevOps, watch Auto DevOps in GitLab 11.0.

Auto DevOps features

Based on the DevOps stages, use Auto DevOps to:

Build your app:

• Auto Build
• Auto Dependency Scanning

Test your app:

• Auto Test
• Auto Browser Performance Testing
• Auto Code Intelligence
• Auto Code Quality
• Auto Container Scanning
• Auto License Compliance

Deploy your app:

• Auto Review Apps
• Auto Deploy

Monitor your app:

• Auto Monitoring

Secure your app:

• Auto Dynamic Application Security Testing (DAST)
• Auto Static Application Security Testing (SAST)
• Auto Secret Detection

Comparison to application platforms and PaaS

Auto DevOps provides features often included in an application platform or in a Platform as a Service (PaaS).

Inspired by Heroku, Auto DevOps goes beyond it in multiple ways:

• Auto DevOps works with any Kubernetes cluster.
• There is no additional cost.
• You can use a cluster hosted by yourself or on any public cloud.
• Auto DevOps offers an incremental graduation path. If you need to customize, start by changing the templates and evolve from there.

Get started with Auto DevOps

To get started, you only need to enable Auto DevOps. This is enough to run an Auto DevOps pipeline to build and test your application.

If you want to build, test, and deploy your app:

1. View the requirements for deployment.
2. Enable Auto DevOps.
3. Follow the quick start guide.

As Auto DevOps relies on many components, be familiar with:

• Continuous methodologies
• Docker
• GitLab Runner

When deploying to a Kubernetes cluster make sure you're also familiar with:

• Kubernetes
• Helm
• Prometheus

Enable or disable Auto DevOps

• Introduced in GitLab 11.3, Auto DevOps is enabled by default.
• Introduced GitLab 12.7, Auto DevOps runs pipelines automatically only if a Dockerfile or matching buildpack exists.

Depending on your instance type, you can enable or disable Auto DevOps at the following levels:

Instance type	Project	Group	Instance (Admin Area)
GitLab SaaS	{check-circle} Yes	{check-circle} Yes	{dotted-circle} No
GitLab self-managed	{check-circle} Yes	{check-circle} Yes	{check-circle} Yes

Before enabling Auto DevOps, consider preparing it for deployment. If you don't, Auto DevOps can build and test your app, but cannot deploy it.

At the project level

To use Auto DevOps for individual projects, you can enable it in a project-by-project basis. If you intend to use it for more projects, you can enable it for a group or an instance. This can save you the time of enabling it one by one.

Prerequisites:

• You must have at least the Maintainer role for the project.
• Ensure your project does not have a .gitlab-ci.yml present. If present, your CI/CD configuration takes precedence over the Auto DevOps pipeline.

To enable Auto DevOps for a project:

1. On the top bar, select Main menu > Projects and find your project.
2. On the left sidebar, select Settings > CI/CD.
3. Expand Auto DevOps.
4. Select the Default to Auto DevOps pipeline checkbox.
5. Optional but recommended. Add the base domain.
6. Optional but recommended. Choose the deployment strategy.
7. Select Save changes.

GitLab triggers the Auto DevOps pipeline on the default branch.

To disable it, follow the same process and clear the Default to Auto DevOps pipeline checkbox.

At the group level

Introduced in GitLab 11.10.

When you enable Auto DevOps at group level, the subgroups and projects in that group inherit the configuration. This saves you some time by batch-enabling it rather than enabling individually for each subgroup or project.

When enabled for a group, you can still disable Auto DevOps for the subgroups and projects where you don't want to use it.

Prerequisites:

• You must have at least the Owner role for the group.

To enable Auto DevOps for a group:

1. On the top bar, select Main menu > Groups and find your group.
2. On the left sidebar, select Settings > CI/CD.
3. Expand Auto DevOps.
4. Select the Default to Auto DevOps pipeline checkbox.
5. Select Save changes.

To disable Auto DevOps on the group level, follow the same process and clear the Default to Auto DevOps pipeline checkbox.

After enabling Auto DevOps at the group level, you can trigger the Auto DevOps pipeline for any project that belongs to that group:

1. On the top bar, select Main menu > Projects and find your project.
2. Make sure the project doesn't contain a .gitlab-ci.yml file.
3. On the left sidebar, select CI/CD > Pipelines.
4. To trigger the Auto DevOps pipeline, select Run pipeline.

At the instance level (FREE SELF)

By enabling Auto DevOps in the instance level, all projects created in that instance become enabled. This is convenient when you want to run Auto DevOps by default for all projects. You can still disable Auto DevOps individually for the groups and projects where you don't want to run it.

Even when disabled for an instance, group Owners and project Maintainers can still enable Auto DevOps at the group and project levels.

Prerequisites:

• You must be an administrator for the instance.

To enable Auto DevOps for your instance:

1. On the top bar, select Main menu > Admin.
2. On the left sidebar, select Settings > CI/CD.
3. Expand Auto DevOps.
4. Select the Default to Auto DevOps pipeline checkbox.
5. Optional. Add the Auto DevOps base domain.
6. Select Save changes.

When enabled, it attempts to run Auto DevOps pipelines in every project. If the pipeline fails in a particular project, it disables itself. GitLab administrators can change this in the Auto DevOps settings.

If a CI/CD configuration file is present, it remains unchanged and Auto DevOps doesn't affect it.

To disable Auto DevOps in the instance level, follow the same process and clear the Default to Auto DevOps pipeline checkbox.

Private registry support

There is no guarantee that you can use a private container registry with Auto DevOps.

Instead, use the GitLab Container Registry with Auto DevOps to simplify configuration and prevent any unforeseen issues.

Quick start

• Use Auto DevOps to deploy to a Kubernetes cluster on Google Kubernetes Engine (GKE)
• Use Auto DevOps to deploy to EC2
• Use Auto DevOps to deploy to ECS

Upgrade Auto DevOps dependencies when updating GitLab

When updating GitLab, you may need to upgrade Auto DevOps dependencies to match your new GitLab version:

• Upgrading Auto DevOps resources:
  • Auto DevOps template.
  • Auto Deploy template.
  • Auto Deploy image.
  • Helm.
  • Kubernetes.
  • Environment variables.
• Upgrading PostgreSQL.

Install applications behind a proxy

The GitLab integration with Helm does not support installing applications when behind a proxy.

To do so, inject proxy settings into the installation pods at runtime. For example, you can use a PodPreset:

NOTE: PodPreset was removed in Kubernetes v1.20.

apiVersion: settings.k8s.io/v1alpha1
kind: PodPreset
metadata:
  name: gitlab-managed-apps-default-proxy
  namespace: gitlab-managed-apps
spec:
  env:
    - name: http_proxy
      value: "PUT_YOUR_HTTP_PROXY_HERE"
    - name: https_proxy
      value: "PUT_YOUR_HTTPS_PROXY_HERE"

Troubleshooting

See troubleshooting Auto DevOps.