Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Tutorial for Conda Migration using Miniforge #805

Open
wants to merge 6 commits into
base: main
Choose a base branch
from

Conversation

iam4tune
Copy link
Contributor

Pull Request

Created a tutorial to guide the migration of environments using Miniforge module on cheaha with the conda-forge and bioconda channels.

Overview

The tutorial walks a user through the steps for moving their environment containing conda packages installed using the default channels to a new environment using the Miniforge module and its channels.

Related Issues

Fixes #793

@iam4tune iam4tune self-assigned this Aug 30, 2024
@wwarriner wwarriner modified the milestone: Sprint 24-18 Sep 18, 2024
wwarriner

This comment was marked as outdated.

Copy link
Contributor

@wwarriner wwarriner left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good start, I think there are a few things worth revising to make it simpler and clearer for our intended audience.

Once everything is structured as we like, we may need to clean up the screenshots to look cleaner and more professional. I've got some tricks I can show you with GIMP that I use frequently. Maybe we can do a group meeting on these tricks since they would benefit everyone.

docs/cheaha/tutorial/migrate_conda_envs.md Outdated Show resolved Hide resolved
docs/cheaha/tutorial/migrate_conda_envs.md Show resolved Hide resolved
docs/cheaha/tutorial/migrate_conda_envs.md Outdated Show resolved Hide resolved
docs/cheaha/tutorial/migrate_conda_envs.md Outdated Show resolved Hide resolved

```

Replace `<new_environment_name>` with your desired new environment name. This command will read from the `environment_backup.txt` file and install the packages from the specified channels like `conda-forge` and `bioconda` channels.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If you say "replace <X>" for any bracketed variables, then you must do the same thing for all bracketed variables.

I think in this case, there is no need to use a bracketed name for the environment. Why not use the migrate_env.txt from earlier? I think it might be helpful to tell them to name it <your_old_environment>.txt. Then there is no ambiguity about which text file is which, in case someone decides to do them all at once.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

And these are .yml files, not .txt files.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I tried this with the .yml files and it threw errors, so I stuck to using the .txt files for transferring the environments.

docs/cheaha/tutorial/migrate_conda_envs.md Outdated Show resolved Hide resolved
@iam4tune iam4tune added this to the Conda Migration milestone Oct 9, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Tutorial for migrating environments to use the conda-forge channel with the Miniforge module
2 participants