Add docs for setting up a local dev environment#71
Conversation
|
Tagging in @ccao-jardine, @TimCookCountyDS, and @Damonamajor for testing this out. |
|
I just added another ticket to get WSL and positron updated. |
|
Thanks @jeancochrane ! I'm testing this out. What are your thoughts on, under the steps for
Or, perhaps overkill? |
|
I like that suggestion @ccao-jardine, though I don't see WSL in the "Software Installation Request" form dropdown. This is also the software that Damon hasn't successfully gotten IT to install yet -- the trick is that WSL 1 comes pre-installed on our laptops, but IT has to remote in with admin privileges to install WSL 2 from the WSL 1 shell. Should we try to work with them to get WSL added to this dropdown, or should we suggest a different path for requesting WSL installation? 
|
|
Let's see how @Damonamajor and I get routed through; I'll follow up. |
|
I was told to restart my computer. I restarted my computer and sent the error message back to IT. |
|
Thanks! Seeing as this is ongoing, let's ignore my suggestion so that this PR isn't blocked. I'll open a ticket if it's worth adding steps about what to do if one's computer doesn't have Positron and/or WSL. |
Damonamajor
left a comment
Damonamajor
left a comment
There was a problem hiding this comment.
Let's talk in office about this. I feel somewhat stuck, but don't know how stuck. I left some general comments on what I've gotten through.
| # The exact link will change depending on the latest Quarto version, so you | ||
| # will need to update the variable definition below to set it to the correct | ||
| # link | ||
| wget -qO quarto.deb "https://<insert-deb-file-url-here>" |
There was a problem hiding this comment.
I'm getting different hashes here, so let's talk through this step.
There was a problem hiding this comment.
OK, make sure to include which .deb file to download and copy full address rather than just copy the link.
| (you can copy and paste this whole block to preserve the line breaks): | ||
|
|
||
| ```bash | ||
| sudo apt install \ |
There was a problem hiding this comment.
This seems like it should be copied and pasted, but the # values don't work in wsl.
| ``` | ||
|
|
||
| ### Mandatory R configurations | ||
|
|
There was a problem hiding this comment.
Do we need to do this a second time if we have already done it for the virtual environment? Where should the different location be, how should it be different?
As noted in positron, an image of what the folder we should open would be useful.
| echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/cran-keyring.gpg] https://cloud.r-project.org/bin/linux/ubuntu $(grep -oP '(?<=UBUNTU_CODENAME=).*' /etc/os-release || lsb_release -cs)-cran40" | sudo tee /etc/apt/sources.list.d/cran.list | ||
|
|
||
| # 3. Refresh the package registry and install R | ||
| sudo apt update && sudo apt install r-base r-base-dev |
There was a problem hiding this comment.
This gives me the following error
sudo apt update && sudo apt install r-base r-base-dev
Error: Malformed entry 1 in list file /etc/apt/sources.list.d/cran.list (Component)
Error: The list of sources could not be read.
It seemed to be related to Codename: resolute which is not listed here (https://cran.r-project.org/bin/linux/ubuntu/fullREADME.html
I was able to presumably download it through forge.
wget https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-Linux-x86_64.sh
bash Miniforge3-Linux-x86_64.sh
conda install -c conda-forge r-base
| [pip](https://pip.pypa.io/en/stable/): | ||
|
|
||
| ```bash | ||
| sudo apt install python3-pip |
There was a problem hiding this comment.
sudo apt update
I had to run that first
3 participants
This PR adds a new doc
Handbook/Local-Dev-Environment-Setup.mdthat documents the steps required to set up a development environment on a local machine (i.e. a laptop).I'm hoping I can get a couple folks to review this for clarity, and then one person (perhaps Kyra or Damon) to test it out and see if all the commands work.
Connects ccao-data/people#33.