You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: jekyll/_cci2/runner-installation-linux.adoc
+9-9Lines changed: 9 additions & 9 deletions
Original file line number
Diff line number
Diff line change
@@ -13,16 +13,16 @@ contentTags:
13
13
:machine:
14
14
:linux:
15
15
16
-
CAUTION: This installation method is deprecated for **CIrcleCI cloud** customers. Refer to the xref:install-machine-runner-3-on-linux#[machine runner 3.0 installation guide] for the recommended steps to set up Linux self-hosted runners on CircleCI cloud.
17
-
18
-
This page describes how to install CircleCI's machine runner on Linux for **CircleCI server** customers.
16
+
CAUTION: This installation method is deprecated for **CircleCI cloud** customers. Refer to the xref:install-machine-runner-3-on-linux#[machine runner 3.0 installation guide] for the recommended steps to set up Linux self-hosted runners on CircleCI cloud.
17
+
18
+
This page describes how to install CircleCI's machine runner on Linux for **CircleCI server** customers.
19
19
20
20
[#prerequisites]
21
21
== Prerequisites
22
22
23
23
To install machine runners and run jobs, you will need to have root access, and have the following utilities and tools installed on your system:
* The xref:local-cli#[CircleCI CLI] if you wish to install runners from the command line
42
42
@@ -66,7 +66,7 @@ To install machine runners and run jobs, you will need to have root access, and
66
66
[#create-the-circleci-user-and-working-directory]
67
67
== 3. Create `circleci` user and working directory
68
68
69
-
These will be used when executing the task-agent. These commands must be run as a user with permissions to create other users (e.g. `root`). For information about GECOS, see the https://en.wikipedia.org/wiki/Gecos_field[wiki page].
69
+
These will be used when executing the task-agent. These commands must be run as a user with permissions to create other users (for example, `root`). For information about GECOS, see the https://en.wikipedia.org/wiki/Gecos_field[wiki page].
70
70
71
71
[#ubuntu-debian]
72
72
=== Ubuntu/Debian
@@ -221,7 +221,7 @@ TimeoutStopSec=18300
221
221
WantedBy = multi-user.target
222
222
```
223
223
224
-
Unlike task-agents, which use the environment of the `circleci` user, launch-agents will need to have any required environment variables (e.g., proxy settings) explicitly defined in the unit configuration file. These can be set by `Environment=` or `EnvironmentFile=`. Please visit the `systemd` https://www.freedesktop.org/software/systemd/man/systemd.exec.html#Environment[documentation] for more information.
224
+
Unlike task-agents, which use the environment of the `circleci` user, launch-agents will need to have any required environment variables (for example, proxy settings) explicitly defined in the unit configuration file. These can be set by `Environment=` or `EnvironmentFile=`. Visit the `systemd` https://www.freedesktop.org/software/systemd/man/systemd.exec.html#Environment[documentation] for more information.
Copy file name to clipboardExpand all lines: jekyll/_cci2/runner-installation-mac.adoc
+2-2Lines changed: 2 additions & 2 deletions
Original file line number
Diff line number
Diff line change
@@ -13,9 +13,9 @@ contentTags:
13
13
:machine:
14
14
:macos:
15
15
16
-
CAUTION: This installation method is deprecated for **CIrcleCI cloud** customers. Refer to the xref:install-machine-runner-3-on-linux#[machine runner 3.0 installation guide] for the recommended steps to set up macOS self-hosted runners on CircleCI cloud.
16
+
CAUTION: This installation method is deprecated for **CircleCI cloud** customers. Refer to the xref:install-machine-runner-3-on-linux#[machine runner 3.0 installation guide] for the recommended steps to set up macOS self-hosted runners on CircleCI cloud.
17
17
18
-
This page describes how to install CircleCI's machine runner on macOS for **CircleCI server** customers.
18
+
This page describes how to install CircleCI's machine runner on macOS for **CircleCI server** customers.
Copy file name to clipboardExpand all lines: jekyll/_cci2/runner-installation-windows.adoc
+4-4Lines changed: 4 additions & 4 deletions
Original file line number
Diff line number
Diff line change
@@ -13,7 +13,7 @@ contentTags:
13
13
:machine:
14
14
:windows:
15
15
16
-
CAUTION: This installation method is deprecated for **CIrcleCI cloud** customers. Refer to the xref:install-machine-runner-3-on-windows#[machine runner 3.0 installation guide] for the recommended steps to set up Windows self-hosted runners on CircleCI cloud.
16
+
CAUTION: This installation method is deprecated for **CircleCI cloud** customers. Refer to the xref:install-machine-runner-3-on-windows#[machine runner 3.0 installation guide] for the recommended steps to set up Windows self-hosted runners on CircleCI cloud.
17
17
18
18
This page describes how to install machine runner on Windows for **CircleCI server**. This has been tested for Windows Server 2019 and Windows Server 2016, both in Datacenter Edition. Other Server SKUs with Desktop Experience and Remote Desktop Services should also work.
19
19
@@ -29,7 +29,7 @@ Since this setup creates a new local administrator user that runs CircleCI jobs,
29
29
30
30
* https://www.gnu.org/software/tar/[tar]
31
31
32
-
* https://www.gnu.org/software/gzip/[gzip]
32
+
* https://www.gnu.org/software/gzip/[Gzip]
33
33
34
34
* The xref:local-cli#[CircleCI CLI] if you wish to install runners from the command line
35
35
@@ -74,7 +74,7 @@ Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManage
74
74
+
75
75
The installation will be output into your PowerShell interface.
76
76
77
-
. As part of the installation, the configuration file for the machine runner (`launch-agent-config.yaml`) will open in Notepad. Please fill the file out with the requested information (see xref:runner-config-reference.adoc[Self-hosted Runner Configuration Reference]). The configuration file is located in the installation directory, `C:\Program Files\CircleCI`, by default.
77
+
. As part of the installation, the configuration file for the machine runner (`launch-agent-config.yaml`) will open in Notepad. Fill the file out with the requested information (see xref:runner-config-reference.adoc[Self-hosted Runner Configuration Reference]). The configuration file is located in the installation directory, `C:\Program Files\CircleCI`, by default.
78
78
79
79
After setup completes, the machine runner starts automatically and begins looking for jobs to process.
80
80
@@ -97,7 +97,7 @@ Uninstalling machine runners will prepare the system for installation again.
== Continuous mode vs. single task mode for Windows self-hosted runners
99
99
100
-
By default, Windows machine runners run in <<runner-config-reference#runner-mode,single task mode>> in order to ensure high reliablity of the underlying technology that the self-hosted runner uses to execute jobs. This is the **recommended mode** for Windows machine runners.
100
+
By default, Windows machine runners run in <<runner-config-reference#runner-mode,single task mode>> in order to ensure high reliability of the underlying technology that the self-hosted runner uses to execute jobs. This is the **recommended mode** for Windows machine runners.
101
101
102
102
A Windows machine runner *can* be run in `continuous` mode, however, doing so eliminates the guarantee of a clean job environment. This may translate into jobs not executing as expected and failing.
0 commit comments