Skip to content

Commit f00e806

Browse files
gschuelergschueler
authored
Merge pull request #1666 from rundeck/gschueler-patch-5
cleanup runner-install
2 parents 1348faf + b1f807f commit f00e806

1 file changed

Lines changed: 0 additions & 288 deletions

File tree

‎docs/administration/runner/runner-installation/runner-install.md‎

Lines changed: 0 additions & 288 deletions
Original file line numberDiff line numberDiff line change
@@ -8,55 +8,6 @@ For most use-cases, the steps outlined in the [Creating Runner](/administration/
88

99
However, there are some advanced installation options that you may want to consider depending on your environment and requirements.
1010

11-
[//]: # (Once you have [created and downloaded a Runner](/administration/runner/runner-installation/creating-runners.md), upload the binary to the environment where it will run and use the following the installation instructions to launch the runner.)
12-
13-
[//]: # (### Pre-Requisites)
14-
15-
[//]: # ()
16-
[//]: # (- Runners can be installed on Windows, Linux or in containers.)
17-
18-
[//]: # ( - The operating systems that we officially support for the Runner are listed [here](/administration/install/system-requirements.md).)
19-
20-
[//]: # ( - Note that the Runner can be installed on a *different* operating system than the self-hosted cluster.)
21-
22-
[//]: # (- Java 11 or Java 17 JRE installed on the Runner's host.)
23-
24-
[//]: # ()
25-
[//]: # (- The Runner binary size is 164MB.)
26-
27-
[//]: # ()
28-
[//]: # (#### Resource Allocation)
29-
30-
[//]: # ()
31-
[//]: # (If setting up Enterprise Runners on virtualized environments, here are baseline recommendations. These are _**general**_ guidelines and the actual resource requirements may vary based on the workload and the number of concurrent executions. It is recommended to monitor the Runner's performance - such as CPU, Memory, and Network Latency - and adjust the resources accordingly.)
32-
33-
[//]: # ()
34-
[//]: # ( | | **Minimum** | **Medium** | **Large** |)
35-
36-
[//]: # ( |---------------|-------------|------------|-----------|)
37-
38-
[//]: # ( | **vCPU** | 4 cores | 8 cores | 12 cores |)
39-
40-
[//]: # ( | **Memory** | 8 GiB | 16 GiB | 32 GiB |)
41-
42-
[//]: # ( | **Java Heap** | 6 GiB | 12 GiB | 24 GiB |)
43-
44-
[//]: # ( | **Storage** | 40 GiB | 40 GiB | 40 GiB |)
45-
46-
[//]: # ()
47-
[//]: # (### Basic Installation steps)
48-
49-
[//]: # ()
50-
[//]: # (1. Copy the Runner JAR file that was saved when the Runner was created to the server and directory where it will run.)
51-
52-
[//]: # (1. Execute `java -jar runner_filename.jar` to start the service.)
53-
54-
[//]: # (1. Connection can be confirmed on the Runner Management page on the Last Checkin line. If there are errors in the output resolve those using troubleshooting steps below: )
55-
56-
[//]: # (1. Runner Logs are located in the ./runner/logs folder under the folder where the jar was executed from. The runner.log file contains operational and important messages about the runner. operations.log tracks an operation starts and if it succeeds or fails. )
57-
58-
[//]: # (Read more about [Runner logging configuration](/administration/runner/runner-management/runner-logging.md) to customize logging.)
59-
6011
## Linux Service for the Runner
6112
The Runner can be installed as a `systemd` service on Linux systems.
6213

@@ -211,239 +162,6 @@ docker run -it \
211162
rundeckpro/runner:{{ $rundeckVersion }}
212163
```
213164

214-
[//]: # (## Deploying Runners in Kubernetes)
215-
216-
[//]: # ()
217-
[//]: # (These instructions will guide how to install a Runner in Kubernetes.)
218-
219-
[//]: # ()
220-
[//]: # (1. [Create an API Token](/manual/10-user.md#user-api-tokens) or use an existing API Token to download a new Runner via API using the following **`curl`** request. Be sure to replace **`[URL]`** and **`[ApiToken]`** **`[ProjectName]`** with your Runbook Automation instance URL and API Token respectively:)
221-
222-
[//]: # ( :::tip Heads Up!)
223-
224-
[//]: # ( Be sure to give each Runner a unique name. This is how you will identify one Runner from another in the platform.)
225-
226-
[//]: # ( :::)
227-
228-
[//]: # ( ```)
229-
230-
[//]: # ( curl --location --request POST 'https://[URL]/api/42/runnerManagement/runners' \)
231-
232-
[//]: # ( --header 'Accept: application/json' \)
233-
234-
[//]: # ( --header 'X-Rundeck-Auth-Token: [ApiToken]' \)
235-
236-
[//]: # ( --header 'Content-Type: application/json' \)
237-
238-
[//]: # ( --data-raw '{)
239-
240-
[//]: # ( "name": "Kubernetes Runner",)
241-
242-
[//]: # ( "description": "Kubernetes runner",)
243-
244-
[//]: # ( "assignedProjects": {)
245-
246-
[//]: # ( "[ProjectName]": ".*",)
247-
248-
[//]: # ( },)
249-
250-
[//]: # ( "tagNames": "kubernetes")
251-
252-
[//]: # ( }')
253-
254-
[//]: # ( ```)
255-
256-
[//]: # (2. The response will provide a **`runnerId`** and **`token`**. Here is an example output:)
257-
258-
[//]: # ( ```)
259-
260-
[//]: # ( {"description":"Kubernetes runner","downloadTk":"d98d21bb-not-real-token-85bcf618ffd0",)
261-
262-
[//]: # ( "name":"Kubernetes Runner","projectAssociations":{"Kubernetes":".*"},)
263-
264-
[//]: # ( "runnerId":"ad45e0c6-not-real-runner-044b4624fff3","token":"NopObWnk1MnotRealTokenvfwJzPTd"})
265-
266-
[//]: # ( ```)
267-
268-
[//]: # (3. (Optional) Verify that the runner was created as intended by navigating to **System Menu** (upper-right gear icon) -> **Runner Management** and see if the Runner is listed.)
269-
270-
[//]: # (4. (Optional) Create a Kubernetes namespace for the Runner: **`kubectl create namespace rundeck`**)
271-
272-
[//]: # (5. Create a deployment YAML for the Runner. Be sure to replace **`[namespace]`**, **`[RUNNER ID]`**, **`[TOKEN]`**, and **`[INSTANCE-SUBDOMAIN]`**:)
273-
274-
[//]: # (```)
275-
276-
[//]: # (apiVersion: v1)
277-
278-
[//]: # (kind: Pod)
279-
280-
[//]: # (metadata:)
281-
282-
[//]: # ( namespace: [namespace])
283-
284-
[//]: # ( name: rundeck-runner)
285-
286-
[//]: # ( labels:)
287-
288-
[//]: # ( app: rundeck-runner)
289-
290-
[//]: # (spec:)
291-
292-
[//]: # ( containers:)
293-
294-
[//]: # ( - image: rundeckpro/runner)
295-
296-
[//]: # ( imagePullPolicy: IfNotPresent)
297-
298-
[//]: # ( name: rundeck-runner)
299-
300-
[//]: # ( env:)
301-
302-
[//]: # ( - name: RUNNER_RUNDECK_CLIENT_ID)
303-
304-
[//]: # ( value: "[RUNNER ID]")
305-
306-
[//]: # ( - name: RUNNER_RUNDECK_SERVER_TOKEN)
307-
308-
[//]: # ( value: "[TOKEN]")
309-
310-
[//]: # ( - name: RUNNER_RUNDECK_SERVER_URL)
311-
312-
[//]: # ( value: "https://[INSTANCE-SUBDOMAIN].runbook.pagerduty.cloud")
313-
314-
[//]: # ( lifecycle:)
315-
316-
[//]: # ( postStart:)
317-
318-
[//]: # ( exec:)
319-
320-
[//]: # ( command:)
321-
322-
[//]: # ( - /bin/sh)
323-
324-
[//]: # ( - -c)
325-
326-
[//]: # ( - touch this_is_from_rundeck_runner)
327-
328-
[//]: # ( restartPolicy: Always)
329-
330-
[//]: # (```)
331-
332-
[//]: # (6. Create the deployment: **`kubectl apply -f deployment.yml`**.)
333-
334-
[//]: # (7. Confirm that the Runner was deployed successfully: **`kubectl logs -f rundeck-runner --namespace=[NAMESPACE]`**)
335-
336-
[//]: # (8. Verify that the Runner is communicating with Runbook Automation correctly by looking in the **Status** column on the Runner Management page:)
337-
338-
[//]: # ( ![Runner installed correctly](/assets/img/runner-installed-k8s.png))
339-
340-
[//]: # (:::tip Tip: Multiple Pods for Scalability)
341-
342-
[//]: # ( Multiple replicas of the Runner container can be associated with a single deployment, though they will appear as a single Runner in Runbook Automation. )
343-
344-
[//]: # ( This is useful for horizontally scaling the Runner. Here is an example deployment yaml where 2 replicas are used:)
345-
346-
[//]: # (```)
347-
348-
[//]: # (apiVersion: apps/v1)
349-
350-
[//]: # (kind: Deployment)
351-
352-
[//]: # (metadata:)
353-
354-
[//]: # ( namespace: rundeck)
355-
356-
[//]: # ( name: rundeck-runner)
357-
358-
[//]: # ( labels:)
359-
360-
[//]: # ( app: rundeck-runner)
361-
362-
[//]: # (spec:)
363-
364-
[//]: # ( replicas: 2)
365-
366-
[//]: # ( selector:)
367-
368-
[//]: # ( matchLabels:)
369-
370-
[//]: # ( app: runner)
371-
372-
[//]: # (template:)
373-
374-
[//]: # ( metadata:)
375-
376-
[//]: # ( labels:)
377-
378-
[//]: # ( app: runner)
379-
380-
[//]: # ( spec:)
381-
382-
[//]: # ( containers:)
383-
384-
[//]: # ( - image: rundeckpro/runner)
385-
386-
[//]: # ( imagePullPolicy: IfNotPresent)
387-
388-
[//]: # ( name: rundeck-runner)
389-
390-
[//]: # ( env:)
391-
392-
[//]: # ( - name: RUNNER_RUNDECK_CLIENT_ID)
393-
394-
[//]: # ( value: "[RUNNER ID]")
395-
396-
[//]: # ( - name: RUNNER_RUNDECK_SERVER_TOKEN)
397-
398-
[//]: # ( value: "[TOKEN]")
399-
400-
[//]: # ( - name: RUNNER_RUNDECK_SERVER_URL)
401-
402-
[//]: # ( value: "[URL]")
403-
404-
[//]: # (```)
405-
406-
[//]: # (Verify that the pods were deployed successfully: )
407-
408-
[//]: # (:::)
409-
410-
[//]: # ()
411-
[//]: # (## Using the Runner on Windows)
412-
413-
[//]: # ()
414-
[//]: # (The “Runner Management” menu will appear on under the “System” settings:)
415-
416-
[//]: # ()
417-
[//]: # (![Runner Architecture](/assets/img/runner-management.png))
418-
419-
[//]: # ()
420-
[//]: # (If you are installing a Runner on a Windows OS as localhost node, you have to specify the “OS Family” setting as “windows”.)
421-
422-
[//]: # ()
423-
[//]: # (- Choose related to the project.)
424-
425-
[//]: # (- Go to the left side bar menu and choose "EDIT NODES".)
426-
427-
[//]: # (- Click on "Resources" tab.)
428-
429-
[//]: # (- Click on "Edit" on the local node.)
430-
431-
[//]: # (- On the field "OS Family" set "windows".)
432-
433-
[//]: # ()
434-
[//]: # (![Runner Architecture](/assets/img/runner-edit-nodes.png))
435-
436-
[//]: # ()
437-
[//]: # (![Runner Architecture](/assets/img/runner-resource-tab.png))
438-
439-
[//]: # ()
440-
[//]: # (![Runner Architecture](/assets/img/runner-edit-local.png))
441-
442-
[//]: # ()
443-
[//]: # (![Runner Architecture](/assets/img/runner-os-family.png))
444-
445-
[//]: # ()
446-
[//]: # (Powershell script steps are fully supported on the Runner. Commands that run through the cmd.exe shell are not supported at the moment.)
447165

448166
## Secure the Runner Deployment
449167

@@ -467,9 +185,3 @@ RUNNER_RUNDECK_SERVER_TOKEN=8FpagGtalnxnv1fmllyYYz4quhNHpBR8
467185
RUNNER_RUNDECK_SERVER_URL=http://192.168.100.2:4440/
468186
```
469187

470-
[//]: # (## Removing Runners)
471-
472-
[//]: # ()
473-
[//]: # (Before removing a Runner it is advisable to verify that there are other active runners tagged with the same tags. This will ensure that jobs that are configured with those tags have at least one available Remote runner to carry out the tasks for the job.)
474-
475-
[//]: # ()

0 commit comments

Comments
 (0)