This is the runbook for deploying new versions of WebPageReplay/Browsertime/Firefox/Chrome.
Update to new version
- SSH to the server:
ssh -i "webpagereplay.pem" firstname.lastname@example.org
- Remove the run file:
- Wait for the tests to finish by tailing the log and look for Exit
tail -f /tmp/webpagereplay.log
- Update to a new Docker container by editing the run file:
nano /home/ubuntu/run.shand change x.y.z to your new version sitespeedio/browsertime:x.y.z
- Start the tests again (the new container will automatically be downloaded):
nohup /home/ubuntu/run.sh &
- Go to the WebPageReplay Grafana dashboard and add an annotation with the tag webpagereplay and a message of what you upgraded
- Keep looking at the graph and verify that everything looks ok.
- Upgrade the other servers to the new version:
ssh -i "webpagereplay.pem" email@example.com
ssh -i "webpagereplay.pem" firstname.lastname@example.org
Deploy first time
wget -qO- https://phab.wmfusercontent.org/file/data/zkk4sg53gjvrt6aw4dio/PHID-FILE-bdwkukgfcanvuh7qgtjt/Install_Browsertime_WebPageReplay_dependencies_on_a_fresh_Ubuntu | bash
The next step is to setup the AWS ID and KEY on the server (to be able to send the result to S3). The easiest way is to get those from one of the current running servers. Login to the server and check the .bashrc file located in the home directory. Look for AWS_ACCESS_KEY_ID and EXPORT AWS_SECRET_ACCESS_KEY and follow the pattern to export them the same way on the new server.