Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update machine setup docs #402

Closed
wants to merge 1 commit into from
Closed

Update machine setup docs #402

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
46 changes: 27 additions & 19 deletions docs/agent-machine-setup.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,47 +1,55 @@
# Setting up a new Crater agent machine

This document contains the steps to configure a new Crater agent machine from
scratch, from an Amazon Linux image. To get a new one ask in `#rust-infra`.
scratch, from an Amazon Linux image. To get a new one ask [in
`#infra`][discord].

The machine type we're currently using is:

* Instance: AWS `c5.2xlarge`
* Storage: 2 Tb
* Storage: 4 Tb
* OS: Amazon Linux 2

You might need to create a smaller root partition and attach the 4 Tb disk on
another directory since we had problems mounting partitions bigger than 2 Tb on
the root directory.

Once they tell you the IP of the machine, ssh with the `ec2-user` user into it
from the bastion server, and execute these commands:

```
curl https://sh.rustup.rs -sSf | sh
source $HOME/.cargo/env
sudo yum install git htop docker gcc cmake openssl-devel
sudo yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
sudo yum install --enablerepo=epel byobu
sudo systemctl start docker
sudo systemctl enable docker
sudo usermod -a -G docker ec2-user

# Configure byobu to use Ctrl+Z instead of Ctrl+A
mkdir ~/.byobu
cat > ~/.byobu/keybindings.tmux << EOF
unbind-key -n C-a
unbind-key -n C-z
set -g prefix ^Z
set -g prefix2 ^Z
bind z send-prefix
EOF
```

Log out of the machine. From the bastion, copy the `~/.aws/credentials` file
from an existing agent into the new one, and then log into it again and
execute:
Log out of the machine and log in again, executing these commands:

```
git clone https://github.com/rust-lang-nursery/crater
cd crater
cargo build --release

# This is going to take a while to complete
cargo run --release -- prepare-local
cat > /etc/systemd/system/crater-agent.service << EOF
[Unit]
Description = Crater agent

[Service]
ExecStart=/home/ec2-user/crater/target/release/crater agent https://crater.rust-lang.org <TOKEN> --threads 8
Restart=on-failure
User=ec2-user
Group=ec2-user
WorkingDirectory=/home/ec2-user/crater

[Install]
WantedBy=multi-user.target
EOF

systemctl enable crater-agent
systemctl start crater-agent
```

[discord]: https://discord.gg/AxXmxzN