Commit 6af17cd1 authored by Suzanne Selhorn's avatar Suzanne Selhorn Committed by Marcel Amirault

More edits to the intro text

Related to: https://gitlab.com/gitlab-org/gitlab/-/issues/300312
parent 03669dea
...@@ -7,14 +7,14 @@ type: concepts, howto ...@@ -7,14 +7,14 @@ type: concepts, howto
# Use Docker to build Docker images # Use Docker to build Docker images
You can use GitLab CI/CD with Docker Engine to build and test Docker-based projects. You can use GitLab CI/CD with Docker to build and test Docker images.
For example, you might want to: For example, you might want to:
1. Create an application image. 1. Create a Docker image of your application.
1. Run tests against the created image. 1. Run tests against the image.
1. Push image to a remote registry. 1. Push the image to a remote registry.
1. Deploy to a server from the pushed image. 1. Use the image to deploy your application to a server.
Or, if your application already has a `Dockerfile`, you can Or, if your application already has a `Dockerfile`, you can
use it to create and test an image: use it to create and test an image:
...@@ -27,7 +27,7 @@ docker push my-registry:5000/my-image ...@@ -27,7 +27,7 @@ docker push my-registry:5000/my-image
``` ```
To run Docker commands in your CI/CD jobs, you must configure To run Docker commands in your CI/CD jobs, you must configure
GitLab Runner to enable `docker` support. GitLab Runner to support `docker` commands.
## Enable Docker commands in your CI/CD jobs ## Enable Docker commands in your CI/CD jobs
......
...@@ -7,27 +7,23 @@ type: concepts, howto ...@@ -7,27 +7,23 @@ type: concepts, howto
# Run your CI/CD jobs in Docker containers # Run your CI/CD jobs in Docker containers
GitLab CI/CD in conjunction with [GitLab Runner](../runners/README.md) can use You can run your CI/CD jobs in separate, isolated Docker containers.
[Docker Engine](https://www.docker.com/) to test and build any application.
Docker is an open-source project that has predefined images you can use to When you run a Docker container on your local machine, it acts as a reproducible build environment.
run applications in independent "containers." These containers run in a single Linux You can run tests in the container, instead of testing on a dedicated CI/CD server.
instance. [Docker Hub](https://hub.docker.com/) is a database of pre-built images you can
use to test and build your applications.
When you use Docker with GitLab CI/CD, Docker runs each job in a separate and isolated To run CI/CD jobs in a Docker container, you need to:
container. You specify the container image in the project's
[`.gitlab-ci.yml`](../yaml/README.md) file.
Docker containers provide a reproducible build environment that - Register a runner that uses the Docker executor. Then all jobs run in a Docker container.
can run on your workstation. When a Docker container is running, you can test - Specify an image in your `.gitlab-ci.yml` file. The runner creates a container from this image
commands from your shell, rather than having to and runs the jobs in it.
test them on a dedicated CI server. - Optional. Specify other images in your `.gitlab-ci.yml` file. These containers are known as
["services"](#what-is-a-service) and you can use them to run services like MySQL separately.
## Register Docker Runner ## Register a runner that uses the Docker executor
To use GitLab Runner with Docker you need to [register a new runner](https://docs.gitlab.com/runner/register/) To use GitLab Runner with Docker you need to [register a runner](https://docs.gitlab.com/runner/register/)
to use the `docker` executor. that uses the Docker executor.
In this example, we first set up a temporary template to supply the services: In this example, we first set up a temporary template to supply the services:
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment