Local Dev Environment Setup
👋 Welcome! We’re excited for you to get our main site running on your computer!
Inform the DevOps team when you’re attempting this session. You will likely experience last-minute unexpected failures someone on that team will be best equipped to deal with.
Notes Before Onboarding
There are a lot of commands and terms here. Setup can be daunting if you haven’t done it before. It’s not just you! *Please ask for help when these get confusing!***
See also Troubleshooting for common issues.
Bootstrap Your Laptop
Protip: This should be run prior to the onboarding session. It takes ~10-15 minutes with very little user interaction.
Follow the instructions in https://github.com/acme-engineering/bootstrap:
git clone https://github.com/acme-engineering/bootstrap.git cd bootstrap ./bootstrap.sh | tee -a bootstrap.log
With Docker installed, go to Docker Preferences → Resources → and increase RAM to 4GB.
Check with an engineer to make sure you’ve been added to both:
- Our private Acme Engineering organization, on the Employees team and your team.
- Our public Acme organization, on the Employees team.
Admins that can make this happen include Jake (@jake), Josh (@josh), Timor (@timor), and engineering managers in general.
Add Your SSH Key to GitHub
Bootstrap should have created the
~/.ssh/id_rsa.pub file; if not, see the GitHub docs.
Login to **GitHub > Settings > SSH and GPG Keys** and select New SSH Key
Copy your public key:pbcopy < ~/.ssh/id_rsa.pub
Paste the contents of the public key into the key field and provide a unique title such as “Acme MacBook”.
Select Add SSH Key.
Click the Enable SSO button on the newly added SSH key and authorize Acme-Engineering.
git config --global user.email <your acme email>