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.

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

Update from feeds: https://galaxyproject.org/news/2024-09-20-esg-byos-im/ #121

Closed
wants to merge 2 commits into from
Closed

Update from feeds: https://galaxyproject.org/news/2024-09-20-esg-byos-im/ #121

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
e79e1ff
Add Bring Your Own Storage with Galaxy for group1
galaxy-social-bot[bot] Sep 28, 2024
ccce83e
Add Bring Your Own Storage with Galaxy for group2
galaxy-social-bot[bot] Sep 28, 2024
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
150 changes: 150 additions & 0 deletions posts/feed_bot/galaxy_europe/2024-09-20-esg-byos-im-group1.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,150 @@
---
media:
- mastodon-eu-freiburg
- matrix-eu-announce
- linkedin-galaxyproject
mentions:
mastodon-eu-freiburg:
- [email protected]
hashtags:
mastodon-eu-freiburg:
- UseGalaxy
- GalaxyProject
- UniFreiburg
- EOSC
- EuroScienceGateway
linkedin-galaxyproject:
- UseGalaxy
- GalaxyProject
- UniFreiburg
- EOSC
- EuroScienceGateway
---
📝 New blog post Released!
https://galaxyproject.org/news/2024-09-20-esg-byos-im/

Introduction
============

The [EuroScienceGateway Project](https://galaxyproject.org/projects/esg/) is streamlining the way that users *Bring their Own Storage (BYOS)* to Galaxy. This post covers a specific case in which a user has access to storage resources in the [EGI Federated Cloud](https://www.egi.eu/service/cloud-compute/) and wants to connect it to the [EU Galaxy instance](https://usegalaxy.eu/). However, similar steps can be followed to connect a different Galaxy instance with storage capacity using [Azure Blob Storage](https://azure.microsoft.com/en-us/products/storage/blobs), [Amazon Web Services S3 Storage](https://aws.amazon.com/s3/), and [Google Cloud Storage](https://cloud.google.com/storage).

In order to connect [Galaxy](https://usegalaxy.eu/) with external cloud storage, the user needs to click on the `User` drop\-down menu, select `Preferences` and then `Manage Your Storage Locations`. This will display a list of the cloud storage services already connected to Galaxy. The first time it will be empty and the user can connect to a new cloud storage service clicking on `Create`. The following options are given to the user:

![Connect Galaxy with cloud storage.](https://galaxyproject.org/news/2024-09-20-esg-byos-im/byos-create.png)

Generally speaking the user needs the following information to connect Galaxy with cloud storage:

1. Name of the bucket
2. Access key
3. Secret key

For `Any S3 Compatible Storage` the user also needs to provide the URL to the API endpoint.

Once filled out correctly the external cloud storage is connected to Galaxy:

![See available cloud storage connected to Galaxy.](https://galaxyproject.org/news/2024-09-20-esg-byos-im/byos-list.png)

Now one interesting option for the user is to select the external cloud storage as the default storage location in Galaxy. For that, the user needs to click on the `User` drop\-down menu, select `Preferences`, `Preferred Storage Location` and then select the newly added connection.

![Choose default cloud storage.](https://galaxyproject.org/news/2024-09-20-esg-byos-im/byos-default.png)

Instead of using a default storage location it is also possible to select it at different levels: per `History`, per `Tool`, and `Workflow`.

Getting S3 storage from EGI
===========================

Users with access to cloud resources in the [EGI Federated Cloud](https://www.egi.eu/service/cloud-compute/) can benefit from the available [TOSCA template](https://github.com/grycap/tosca/blob/f8cf9f2b11ba1de4d8639ad04728de23d25d0299/templates/minio_compose.yaml) in [Infrastructure Manager (or IM)](https://im.egi.eu/) for the automated deployment of [MinIO](https://min.io/).

Below are the steps that a user needs to follow to make use of computing resources in the EGI Federated Cloud:

1. [Create an EGI Check\-in account](https://docs.egi.eu/users/aai/check-in/signup/).
2. [Enroll in a Virtual Organization (VO)](https://docs.egi.eu/users/aai/check-in/joining-virtual-organisation/). You need to wait for approval before moving on.
3. Once you are a member of a VO, [configure credentials in Infrastructure Manager](https://docs.egi.eu/users/compute/orchestration/im/dashboard/#cloud-credentials).
4. In [Infrastructure Manager](https://im.egi.eu/) select `Deploy a VM` and click `Configure`.
5. Select `MinIO` and click `Add`.
6. Configure deployment details for MinIO and click `Submit`.

A prerequisite for the deployment of MinIO with IM is the use of some sort of Dynamic DNS service. EGI also offers a [Dynamic DNS service](https://docs.egi.eu/users/compute/cloud-compute/dynamic-dns/) for free for users with an EGI Check\-in account (see a [tutorial](https://youtu.be/waylAJ4p-LA) for further help). Using a Dynamic DNS service the user needs to register two DNS hostnames: one DNS hostname for the `MinIO Console`, and another one for the `MinIO API endpoint`.

IM will deploy a Virtual Machine with Docker and MinIO as a containerised service. Therefore, the first step for the user is to select `Deploy a VM` in IM:

![Deploy a VM with IM.](https://galaxyproject.org/news/2024-09-20-esg-byos-im/esg-im-minio-01.png)

After selecting the option `Deploy a VM` in IM the user is presented with several options to deploy services on top of a Virtual Machine. The Figure below shows the filtered output when looking for MinIO. The user needs to click on `Add` and then `Configure`:

![Add MinIO and Configure VM.](https://galaxyproject.org/news/2024-09-20-esg-byos-im/esg-im-minio-02.png)

In the configuration page for the deployment in IM (see Figure below) the user needs to enter:

1. The release tag from https://github.com/minio/minio/tags for the deployment.
2. The desired access and secret key for MinIO.
3. Dynamic DNS configuration for both the Console and the API endpoint.
4. An email address used by [certbot](https://certbot.eff.org/) when registering the TLS certificates.

![Configure MinIO in IM.](https://galaxyproject.org/news/2024-09-20-esg-byos-im/esg-im-minio-03.png)

Once all the parameters are configured for MinIO and the VM, the user needs to choose a cloud provider for the deployment. This is done selecting the cloud credentials configured earlier and the Virtual Machine Image for the deployment as shown in the Figure below:

![Select cloud provider in IM.](https://galaxyproject.org/news/2024-09-20-esg-byos-im/esg-im-minio-04.png)

All going well IM will show the deployment as `Configured`:

![Deployment status in IM.](https://galaxyproject.org/news/2024-09-20-esg-byos-im/esg-im-minio-05.png)

Now the user should click on the `Outputs` button under the `Actions` column to get the URL for both the MinIO Console and the API endpoint. The latter is the URL that needs to be added to Galaxy to connect with this S3 endpoint.

![MinIO configuration IM.](https://galaxyproject.org/news/2024-09-20-esg-byos-im/esg-im-minio-06.png)

Along with the URL for the MinIO API endpoint, the user will also need to generate an access and secret key in MinIO that will then be used in Galaxy to connect to this cloud storage:

![MinIO configuration IM.](https://galaxyproject.org/news/2024-09-20-esg-byos-im/esg-im-minio-07.png)

Adding MinIO bucket to Galaxy
=============================

Once the MinIO service is up and running the user can create a bucket in MinIO. This is done by accessing the MinIO Console URL and logging in with the access and secret key generated earlier. The user can then create a bucket by clicking on the `Create Bucket` button in the top right corner of the screen and adding a name for the bucket:

![Create a bucket in MinIO.](https://galaxyproject.org/news/2024-09-20-esg-byos-im/minio-create-bucket.png)

The user can then add this bucket to Galaxy by following the steps described at the beginning of this post (Select `Any S3 Compatible Storage` option from the available templates). The user needs to provide a `Name`, `Access Key ID`, `Bucket` (name of the bucket), the `S3-Compatible API Endpoint` (MinIO API endpoint), the `Secret Access Key` and submit the form.

![Add your MinIO bucket to Galaxy.](https://galaxyproject.org/news/2024-09-20-esg-byos-im/byos-add-minio-bucket-to-galaxy.png)

Once the bucket is added to Galaxy the user can start using it as the default storage location or select it at different levels: per `History`, per `Tool`, and `Workflow`.

![Newly added external storage.](https://galaxyproject.org/news/2024-09-20-esg-byos-im/byos-your-newly-added-external-storage.png)

Running workflows in Galaxy with Bring Your Own Storage
=======================================================

The user can now run tools and workflows in Galaxy using the newly configured external storage. Below is an example of a workflow that performs the assembly of bacterial genomes using [Shovill](https://usegalaxy.eu/?tool_id=shovill) a faster *de novo* assembly pipeline for Illumina paired end reads.

Steps to run the workflow:
--------------------------

1. Create a new history in Galaxy.
2. Select the newly added external storage as the preferred storage location for the `History`.

![Set storage for this history.](https://galaxyproject.org/news/2024-09-20-esg-byos-im/byos-history-level-selection.png)

3. Upload / Import the [input data](https://usegalaxy.eu/published/history?id=8ac959df218c9188).
4. Go to the `Workflow` tab and select the workflow and run it.

![Set storage for this history.](https://galaxyproject.org/news/2024-09-20-esg-byos-im/run-galaxy-workflow.png)

5. Once the workflow is completed, the user can find all the output files in the external storage.

![Successful completion of workflow run](https://galaxyproject.org/news/2024-09-20-esg-byos-im/successful-completion-of-the-workflow-invocation.png)

See below the output files in the external storage.

![Output files in external storage.](https://galaxyproject.org/news/2024-09-20-esg-byos-im/all-workflow-datasets-now-in-the-bucket.png)

6. The user can also evaluate it by clicking the `Dataset details` of a job and observe that the user's external storage is used as the `Dataset Storage`.

![Dataset details showing external storage.](https://galaxyproject.org/news/2024-09-20-esg-byos-im/dataset-storage-location.png)

Conclusions
===========

Having the possibility to connect Galaxy with external storage capacity enables great flexibility for both the end user and the Galaxy administrator. The end user can benefit from extra storage capacity easily. The Galaxy administrator does not have to look after additional storage systems. All in all, this *Bring your Own Storage (BYOS)* approach allows Galaxy to scale up the number of users in a more sustainable way, thanks to the work of John Chilton and colleagues [upstream](https://github.com/galaxyproject/galaxy/pull/18127).
Loading