How to Run, Install, Start, and Stop Atlassian Bamboo Remote Agents
Managing your Atlassian Bamboo Remote Agents can be a breeze once you understand the initial setup and the commands needed to control the service. Let’s dive into the process of getting your agent up and running and explore how to manage it effectively.
Initial Run and Setup Scripts
When you run your agent for the first time, it generates control scripts to handle the installation and service management. To start the agent, use the following command, making sure to replace <Bamboo Base URL> with your Bamboo server’s base URL:
java [parameters] -jar atlassian-bamboo-agent-installer-X.X-SNAPSHOT.jar <Bamboo Base URL>/agentServer/ [console]
Stopping the Agent
There might be times when you need to stop your remote agent. To do this, you can identify the process and force it to terminate using the following commands:
ps aux | grep -i bamboo | awk '{print $2}' | xargs kill -9
Installation Directory
Move to the directory where the Bamboo agent is installed. In this example, we use:
cd /home/bamboo/bamboo-agent-home/bin
bash bamboo-agent.sh install
Once installed, you can manage the Bamboo agent service using systemctl commands:
systemctl enable bamboo-agent.service
systemctl start bamboo-agent.service
systemctl stop bamboo-agent.service
systemctl status bamboo-agent.service
Additionally, the Bamboo agent script supports several options:
• console - Run the agent in the foreground.
• start - Start the agent.
• stop - Stop the agent.
• restart - Restart the agent (executing stop followed by start).
• status - Check the status of the agent.
• dump - Take a thread dump using kill -3.
systemd Configuration
The configuration for systemd can be found at /etc/systemd/system/bamboo-agent.service. Here’s an example of how the file should look:
[Unit]
Description=Bamboo Agent
After=syslog.target
[Service]
Type=forking
User=bamboo
Group= bamboo
ExecStart=/home/bamboo/bamboo-agent-home/bin/bamboo-agent.sh start sysd
ExecStop=/home/bamboo/bamboo-agent-home/bin/bamboo-agent.sh stop sysd
KillMode=control-group
Environment=SYSTEMD_KILLMODE_WARNING=true
[Install]
WantedBy=multi-user.target
Make sure you set the correct permissions for this file and reload systemd configurations to reflect the changes:
systemctl daemon-reload
By following the steps outlined above, you’ll ensure that your Bamboo Remote Agent is installed properly, and you’ll gain the ability to manage the service with confidence. Remember that proper service management is key to maintaining a stable build environment in continuous integration and continuous deployment pipelines.
Comments
Post a Comment