add conda/mamba environment file for local deployment?

[MathewBiddle]

I recently had to use a loaner laptop and needed to build out my environments again. As I was doing so, I thought that it would be helpful to have an environment just for docs and we could add that environment file to this repo (or one of the submodules).

Then the readme here would be:

git clone https://github.com/ioos/ioos-documentation-jekyll-skeleton.git

conda create env -f environment.yml

bundle exec jekyll serve --config _config.yml --watch --verbose --incremental

Might be missing some key details.

[MathewBiddle]

Found a good blog with an example workflow: https://hackmd.io/@AstrobioMike/jekyll-conda-setup

conda create -y -n jekyll -c conda-forge rb-jekyll c-compiler compilers cxx-compiler

conda activate jekyll

gem install bundler

# running this in the repo with the Gemfile
bundle update

# make sure these are all being called from the same conda environment (and no other system-wide ones are mucking things up)
where ruby
where bundle
where bundler
where gem

bundle exec jekyll serve

[ocefpaf]

I guess that the devil is in the details I had to do this the last time I used jekyll with an IOOS Gemfile on Linux:

conda env create --name JEKYLL compilers "ruby<3"
gem update --system
gem install sass-embedded -v 1.63.6
gem install jekyll
gem install bundler
bundle install
ln -s /home/filipe/micromamba/envs/JEKYLL/bin/ruby /home/filipe/micromamba/envs/JEKYLL/share/rubygems/bin/ruby
bundle exec jekyll serve --config _config.yml,_config_dev.yml --watch

The main differences are:

• install the compilers package instead of the individual compilers (that is safer when updating the env).
• update before installing
• pin SASS b/c the latest one did not work with jekyll
• created a symlink b/c for some reason, ruby could not be found
• used both dev and normal config when building locally to avoid mismatched slugs

[MathewBiddle]

Okay, so that's not as easy as I was hoping. If it's that complex, than maybe the environment file isn't worth the effort? Folks can just install to their OS directly, per our guidance here.

[ocefpaf]

Okay, so that's not as easy as I was hoping. If it's that complex, than maybe the environment file isn't worth the effort? Folks can just install to their OS directly, per our guidance here.

The problem is the many layers of packages and managers. We use conda to install gems to install bundle :-/