Skip to content

feat: add profile info #20

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.

Sign up for GitHub

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

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

feat: add profile info #20

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
d0a8ea2
feat: added profiles directory with a README.txt
cmeesters Oct 26, 2025
a1b6b49
feat: included information to the profiles directory
cmeesters Oct 26, 2025
73e9dc2
Update profiles/README.txt
cmeesters Oct 26, 2025
04f13c0
Update README.md
cmeesters Oct 26, 2025
014867f
fix: added missing content section
cmeesters Oct 26, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,7 @@ A Snakemake workflow for `<description>`
- [Snakemake workflow: `<name>`](#snakemake-workflow-name)
- [Usage](#usage)
- [Deployment options](#deployment-options)
- [The "profiles" Directory](#the-profiles-directory)
Copy link
Member

@m-jahn m-jahn Oct 26, 2025

Choose a reason for hiding this comment

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

directory lower-case

- [Authors](#authors)
- [References](#references)
- [TODO](#todo)
Expand Down Expand Up @@ -50,6 +51,14 @@ Run the workflow with:
snakemake --cores 2 --sdm conda apptainer --directory .test
```

## The "profiles" Directory
Copy link
Member

@m-jahn m-jahn Oct 26, 2025

Choose a reason for hiding this comment

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

directory lower-case


When developing on a cluster or cloud instance, please include a "profiles" directory:

`profiles/<cluster or cloud name>/config.yaml`

This configuration file should contain the workflow profile with its resource specification for a particular execution environment (cluster or cloud). You may include a readme file next to point out pitfalls or other aspects worth a user's consideration.

## Authors

- Firstname Lastname
Expand Down
9 changes: 9 additions & 0 deletions profiles/README.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
A 'profiles' directory might contain workflow resource configuration for a particular cluster or cloud instance.

We encourage to include a profile for your use case as:

`profiles/<your cluster or cloud instance>/config.yaml`

You may include a readme file next to the config.yaml file to point out pitfalls or other things to consider.
Copy link
Member

@m-jahn m-jahn Oct 26, 2025

Choose a reason for hiding this comment

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

You may include a README.md file [...]


We welcome pull requests for 3rd-party workflows you are working with to include such a profile! It may also be necessary to occasionally label certain rules of a particular workflow with the `localrules: <rule 1>, <rule 2>, ...` directive when workflow developers focused on server execution during development, e.g., plotting and download rules.
Loading