Merge pull request #67 from ASFOpenSARlab/dp/update-deploy-environment

feat: migrate env manager to `mamba`

Author: dgpalmieri

.github/workflows/deploy_jupyter_book.yaml

@@ -22,28 +22,27 @@ concurrency:
 jobs:
   deploy-book:
     runs-on: ubuntu-latest
+    defaults:
+      run:
+        shell: bash -l {0}
     environment:
       name: github-pages
       url: ${{ steps.deployment.outputs.page_url }}
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v6
 
-    - name: Set up Python 3.11
-      uses: actions/setup-python@v5
+    - uses: actions/setup-python@v6
       with:
-        python-version: '3.11'
-        cache: pip # Implicitly uses requirements.txt for cache key
+        python-version: '3.14'
 
-    - name: Install dependencies
-      run: make install-deps
+    - uses: mamba-org/setup-micromamba@v2
+      with:
+        environment-file: environment.yaml
 
-    - name: Build the book
-      run: |
-        make build
+    - run: make build
 
-    - name: Upload artifact
-      uses: actions/upload-pages-artifact@v3
+    - uses: actions/upload-pages-artifact@v4
       with:
         path: "_build/html"
 

Makefile

@@ -1,6 +1,6 @@
 .PHONY := install-deps
 install-deps:
-	python3 -m pip install -r requirements.txt && \
+	mamba env create -f environment.yaml && \
 	curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash && \
 	\. "$$HOME/.nvm/nvm.sh" && \
 	nvm install 24

README.md

@@ -12,8 +12,9 @@ Action, and includes a custom domain in the Pages settings in the repo.
 
 ### Local Development
 
-Create a virtual environment with the tool of your choice, then you can install the
-dependencies (from `requirements.txt`) with `make install-deps`.
+With [`mamba`](https://mamba.readthedocs.io/en/latest/installation/mamba-installation.html)
+installed, `make install-deps` will create a local environment `docs` with all the
+dependencies installed.
 
 `make serve` will start a Jupyter Book server, which includes hot reload on file save,
 so after you open the local server page in your browser, saving a file will

environment.yaml

@@ -0,0 +1,7 @@
+name: docs
+channels:
+  - conda-forge
+  - nodefaults
+dependencies:
+  - jupyter-book==2.1.0
+  - mystmd==1.7.0

release-notes/release_07-2025.md

@@ -4,7 +4,7 @@ Welcome to the June 2025 OpenScienceLab Update!
 
 ### Changes:
 
-We've upgraded our documentation to use [Jupyter Book version 2](https://next.jupyterbook.org/)!
+We've upgraded our documentation to use [Jupyter Book version 2](https://jupyterbook.org/)!
 
 We've also updated the documentation to better reflect the current state of
 OpenScienceLab -- please note that the Developer Documentation is quite out of date and