jaapel / planetary-computer-tutorial

planetary-computer-tutorial

Accessing the content on Planetary Computer

1. Open the Planetary Computer JupyterHub
2. Open a shell by clicking on the + sign and select "terminal"
3. Run the following command:

   mkdir -p ~/dev/
   cd ~/dev

4. Fork the tutorial repository
5. Go back to the Planetary Computer shell, clone your forked tutorial repository to Planetary Computer by running:

   git clone https://github.com/<GITHUB_USER>/planetary-computer-tutorial.git

6. Now you can find the repository in the file browser on the left.
7. Add a token and storage account in the .env file to access the datasets that you need. You can ask Floris Calkoen for a token. If you are unfamiliar with vim keybindings, press "i" to go into insert mode and use it as your regular text editor.

   cp ~/dev/planetary-computer-tutorial/.env.example ~/dev/planetary-computer-tutorial/.env
   vim ~/dev/planetary-computer-tutorial/.env

Pushing your changes to GitHub from Planetary Computer

1. You need to configure Git by SSH to commit your changes to Github.
2. https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent?platform=linux
3. sh-keygen -t ed25519 -C "<YOUR_EMAIL>"
4. Enter, enter, enter.
5. chmod 600 ~/.ssh/id_ed25519
6. ssh-add ~/.ssh/id_ed25519
7. Follow these instructions to add the ssh key to your GitHub profile.
8. Add your remote fork as origin:

   git remote set-url origin [email protected]:<USER_NAME>/planetary-computer-tutorial.git

9. Once you re-start your Planetary Computer hub you might have to change the permissions on the file again by running:

   chmod 600 ~/.ssh/id_ed25519