Student Development Environment (mac)

This is a short list, but it will take a few days to get through the entire thing, assuming nothing goes wrong (something will go wrong)


Other required tools: Slack, dropbox, outlook, https://is.oregonstate.edu/microsoft, jamf?

Download browsers

  • Chrome
  • Firefox
  • Firefox Dev
  • any others you think you'll want for testing (Opera, etc)

Start with a bit of house cleaning

House cleaning link. (There are a lot of good general development settings and tools in this guide, though it won't show you how to set up a drupal environment, but bookmark it for reference.)

  • Start with System Preferences section
  • Homebrew section.
  • iTerm section and just the zsh section
  • Vim section (May as well. Vim is a text editor that's only a few years younger than me, and is based on the text editor vi which is older than you and I put together, but you'd be surprised how often it comes up. It's very, very, very different from other text editors. After you install, run the command 'vimtutor' in the terminal and play through a few vim exercises. You won't need to do more than a handful of them.)
  • VSCode section, but only grab the javascript, sql, and vs code icons extensions. (You'll get plenty of others as you work with VSCode more.)
  • Show hidden files https://techstacker.com/how-to-always-show-hidden-files-finder-macos/ (careful with this one. you might not want to do it on your personal computer)


Side note – Dracula is a nice cohesive set of themes for your environments, but there's lots of others. 
I use vscode with the niteowl theme.

Get git

Configure git and install it, if you haven't already installed it. (what is git and how do I use it) Let me know if you don't have a github account yet, and we'll set that up for you.


Add Keys to Github

Tell me your github username so I can add you to our repositories, then follow these steps to generate keys.

https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent

https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account


Install vpn

https://is.oregonstate.edu/vpn


Add K8s and K9s

/wiki/spaces/LTD/pages/54875904 (this is just for your local environment, written by Ryan and Christa)

Install k9s for a clean ui for kubernetes (via brew is fine)


Docker

https://docs.docker.com/desktop/mac/install/

Docker projects should be placed in a folder that's different from the 'sites folder' created below.

Non-docker projects

https://getgrav.org/blog/macos-monterey-apache-multiple-php-versions

for each version of php, you'll have a php.ini file. set the

memory_limit = 256M or 512M

You may also need to raise the file size upload.

  • upload_max_filesize = 10M
  • post_max_size = 10M

Also do part 2, but only the MariaDB section


Final steps

Make sure to add the 'sites' and 'docker' folder to your finder sidebar

Put the Application Inventory in your bookmarks toolbar

Make it all pretty (you don't have to use the dracula theme, but this link will show you the basics of adding themes)


Something has gone horribly wrong!

Read some docs, read the comments, and google, google, google.