Use spawn for multiple agents

... on Debian, Red Hat, and Ubuntu docs.
buildkite · Jul 10, 2023 · fd7fb8d · fd7fb8d
1 parent 23c3cd2
commit fd7fb8d
Show file tree

Hide file tree

Showing 4 changed files with 5 additions and 57 deletions.
diff --git a/pages/agent/v3/_linux_multiple_agents.md b/pages/agent/v3/_linux_multiple_agents.md
@@ -0,0 +1,2 @@
+You can run as many parallel agent workers on the one machine as you wish with
+the `spawn` configuration setting, or by passing the `--spawn` flag.
diff --git a/pages/agent/v3/debian.md b/pages/agent/v3/debian.md
@@ -88,25 +88,7 @@ On Debian, the Buildkite agent runs as user `buildkite-agent`.
 
 ## Running multiple agents
 
-You can run as many parallel agents on the one machine as you wish by duplicating the systemd/upstart service configuration file, for example:
-
-```shell
-# Disable the default unit
-sudo systemctl stop buildkite-agent && sudo systemctl disable buildkite-agent
-
-# Create a systemd template
-sudo cp /lib/systemd/system/buildkite-agent.service /etc/systemd/system/buildkite-agent@.service
-
-# Now, as many times as you like
-sudo systemctl enable buildkite-agent@1 && sudo systemctl start buildkite-agent@1
-sudo systemctl enable buildkite-agent@2 && sudo systemctl start buildkite-agent@2
-
-# Follow them all
-sudo journalctl -f -u "buildkite-agent@*"
-
-# Or one-by-one
-sudo journalctl -f -u buildkite-agent@2
-```
+<%= render_markdown partial: 'agent/v3/linux_multiple_agents' %>
 
 ## Upgrading
 

diff --git a/pages/agent/v3/redhat.md b/pages/agent/v3/redhat.md
@@ -72,25 +72,7 @@ On RedHat, the Buildkite agent runs as user `buildkite-agent`.
 
 ## Running multiple agents
 
-You can run as many parallel agents on the one machine as you wish by duplicating the systemd service configuration file, for example:
-
-```shell
-# Disable the default unit
-sudo systemctl stop buildkite-agent && sudo systemctl disable buildkite-agent
-
-# Create a systemd template
-sudo cp /usr/lib/systemd/system/buildkite-agent.service /etc/systemd/system/buildkite-agent@.service
-
-# Now, as many times as you like
-sudo systemctl enable buildkite-agent@1 && sudo systemctl start buildkite-agent@1
-sudo systemctl enable buildkite-agent@2 && sudo systemctl start buildkite-agent@2
-
-# Follow them all
-sudo journalctl -f -u "buildkite-agent@*"
-
-# Or one-by-one
-sudo journalctl -f -u buildkite-agent@2
-```
+<%= render_markdown partial: 'agent/v3/linux_multiple_agents' %>
 
 ## Upgrading
 

diff --git a/pages/agent/v3/ubuntu.md b/pages/agent/v3/ubuntu.md
@@ -69,25 +69,7 @@ See the [Agent SSH keys](/docs/agent/v3/ssh-keys) documentation for more details
 
 ## Running multiple agents
 
-You can run as many parallel agents on the one machine as you wish by duplicating the upstart service configuration file, for example:
-
-```shell
-# Disable the default unit
-sudo systemctl stop buildkite-agent && sudo systemctl disable buildkite-agent
-
-# Create a systemd template
-sudo cp /lib/systemd/system/buildkite-agent.service /etc/systemd/system/buildkite-agent@.service
-
-# Now, as many times as you like
-sudo systemctl enable --now buildkite-agent@1
-sudo systemctl enable --now buildkite-agent@2
-
-# Follow them all
-sudo journalctl -f -u "buildkite-agent@*"
-
-# Or one-by-one
-sudo journalctl -f -u buildkite-agent@2
-```
+<%= render_markdown partial: 'agent/v3/linux_multiple_agents' %>
 
 ## Upgrading