Commit ac0de534 authored by Achilleas Pipinellis's avatar Achilleas Pipinellis 🏖

Merge branch 'docs/clarify-runner-setup' into 'master'

Improve runner config docs

See merge request gitlab-org/gitlab-development-kit!684
parents d2e8386c b718442f
......@@ -12,12 +12,23 @@ Start by [preparing your computer](../prepare.md) and
In some configurations, GitLab Runner needs access to GitLab from inside a
Docker container, or even another machine, which isn't supported in the default
configuration. If you intend to just use the "shell" executor (fine for very
simple jobs), you can use GDK with its default settings and skip the special
setup below. If GDK is already running, you'll need to restart it after making
configuration.
### Simple configuration
If you intend to just use the "shell" executor (fine for very
simple jobs), you can use GDK with its default settings and skip the Advanced
configuration below. If GDK is already running, you'll need to restart it after making
these changes.
Otherwise, ensure you have Docker installed, then set up GitLab to bind to all
With GDK running:
1. Navigate to `http://localhost:3000/admin/runners` (log in as root)
1. Make note of the `Registration token`.
### Advanced configuration
Ensure you have Docker installed, then set up GitLab to bind to all
IPs on your machine by following [these instructions](local_network.md)
(in short: `echo "0.0.0.0" > host` in the GDK root directory). Without this
step, builds will fail with a 'connection refused' error.
......
......@@ -141,8 +141,10 @@ You can also override the host name used by the Rails instance (specified by the
gdk reconfigure
```
If you want to work on GitLab CI you will need to install [GitLab Runner](https://gitlab.com/gitlab-org/gitlab-runner).
To enable the OpenLDAP server, see the OpenLDAP instructions in this [README](./howto/ldap.md).
After installation [learn how to use GDK](./howto/README.md).
### Enabling GitLab CI/CD in GDK
If you want to work on GitLab CI/CD, see [Using GitLab Runner with GDK](howto/runner.md).
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