Skip to content

Commit

Permalink
Merge pull request #4983 from galaxyproject/bigeye-heptatonic
Browse files Browse the repository at this point in the history
import onedata blogpost
  • Loading branch information
shiltemann authored Jun 3, 2024
2 parents 3ceb9b6 + 78739a7 commit 747daa9
Show file tree
Hide file tree
Showing 3 changed files with 93 additions and 0 deletions.
6 changes: 6 additions & 0 deletions ORGANISATIONS.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -123,3 +123,9 @@ jetstream2:
url: https://jetstream-cloud.org/
avatar: https://jetstream-cloud.org/images/home/jetstream-2.png
github: false

egi:
name: EGI
url: https://www.egi.eu/
avatar: https://cdn.egi.eu/app/uploads/2021/11/egi-logo.svg
github: false
87 changes: 87 additions & 0 deletions news/_posts/2024-06-03-onedata.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,87 @@
---
title: All GTN training data are now automatically mirrored via Onedata
contributions:
authorship:
- plushz
funding:
- eurosciencegateway
- egi
tags: [esg-wp4, esg]
cover: news/images/galaxy-data-upload.png
coveralt: screenshot of galaxy data upload interface showing a folder named GTN Training Data
layout: news
---



As part of the [EuroScienceGateway](https://eurosciencegateway.eu/) and in cooperation with [Onedata](https://onedata.org) and [EGI](https://www.egi.eu/) we are providing all [GTN](https://training.galaxyproject.org/) training data on a publicly accessible [cloud storage](https://datahub.egi.eu/share/2697e33bd34f1870b0961414b8c77753chf583).
Those training datasets are curated, small but meaningful for educational purposes and contain 1530 files with a total size of 170Gb.
An invaluable set of resources for everyone dealing with data science and training.
Please thank the more than [350 contributors to GTN]({% link hall-of-fame.md %}).

## What does this mean for you?

- Teachers: if you're a teacher contributing to the GTN, you can now be sure that the datasets you use in your materials are even more accessible and easier to use.
- GTN Users: When following training materials, it'll now be easier to access those same datasets in new locations.
- Galaxy Admins: If you're running a Galaxy server, you can now more easily integrate the GTN data into your server without taking up unnecessary storage space, and still making it available to all your users.

## Accessing GTN Data in the Cloud

GTN training data is always accessible, annotated and linked for every tutorial. Usually, it's stored in Zenodo, referenced via a DOI.
You can access all GTN training data using several methods:

1. **Onedata Share** — access without authentication:

a. Visit the [public share link](https://datahub.egi.eu/share/2697e33bd34f1870b0961414b8c77753chf583)
to browse and download the data via the Onedata Web UI.

b. Use the public [REST API](https://onedata.org/#/home/api/stable/onezone?anchor=operation/get_shared_data)
to access the data; on the share page (see above) you will find ready-to-use `curl` examples by right-clicking on a file/directory and choosing the **Information** context menu.

2. **Galaxy Server integration**: access the data on the [European Galaxy server](https://usegalaxy.eu/). Go to the "Upload data" button, select "Choose remote files," and navigate to the GTN repository.

3. **Configure your own Galaxy server**: to include the GTN data in your Galaxy server, use the following configuration:

```yaml
- type: onedata
id: gtn_public_onedata
label: GTN training data
doc: Training data from the Galaxy Training Network (powered by Onedata)
# The following token is a public, read-only token that can be shared.
accessToken: "MDAxY2xvY2F00aW9uIGRhdGFodWIuZWdpLmV1CjAwNmJpZGVudGlmaWVyIDIvbm1kL3Vzci00yNmI4ZTZiMDlkNDdjNGFkN2E3NTU00YzgzOGE3MjgyY2NoNTNhNS9hY3QvMGJiZmY1NWU4NDRiMWJjZGEwNmFlODViM2JmYmRhNjRjaDU00YjYKMDAxNmNpZCBkYXRhLnJlYWRvbmx5CjAwNDljaWQgZGF00YS5wYXRoID00gTHpaa1pUTTROMkl4WmpjMllXVmpOMlU00WWpreU5XWmtNV00ZpT1RKbU1ETXlZMmhoWTJReAowMDJmc2lnbmF00dXJlIIQvnXp01Oey02LnaNwEkFJAyArzhHN8SlXSYFsBbSkqdqCg"
onezoneDomain: "datahub.egi.eu"
```
4. **Onedata clients** — access the data using the public read-only access token and
[Oneclient](https://www.onedata.org/#/home/documentation/21.02/user-guide/oneclient.html) (local POSIX mount)
or [OnedataFS](https://onedata.org/#/home/documentation/21.02/user-guide/onedatafs.html)
([PyFilesystem](https://www.pyfilesystem.org/) interface), e.g.:
```bash
mkdir ~/oneclient
oneclient \
-H plg-cyfronet-01.datahub.egi.eu \
-t MDAxY2xvY2F00aW9uIGRhdGFodWIuZWdpLmV1CjAwNmJpZGVudGlmaWVyIDIvbm1kL3Vzci00yNmI4ZTZiMDlkNDdjNGFkN2E3NTU00YzgzOGE3MjgyY2NoNTNhNS9hY3QvMGJiZmY1NWU4NDRiMWJjZGEwNmFlODViM2JmYmRhNjRjaDU00YjYKMDAxNmNpZCBkYXRhLnJlYWRvbmx5CjAwNDljaWQgZGF00YS5wYXRoID00gTHpaa1pUTTROMkl4WmpjMllXVmpOMlU00WWpreU5XWmtNV00ZpT1RKbU1ETXlZMmhoWTJReAowMDJmc2lnbmF00dXJlIIQvnXp01Oey02LnaNwEkFJAyArzhHN8SlXSYFsBbSkqdqCg \
~/oneclient
ls ~/oneclient/GTN\ data
```

## What is the GTN Downloader?

[GTN-Downloader](https://github.com/usegalaxy-eu/gtn-downloader) makes it easier for users to access and organize data from the [Galaxy Training Network (GTN)](https://training.galaxyproject.org/).
The GTN Downloader is a Python script that automates the download of data from GTN tutorials. It goes through the tutorials in the GTN repository, finds `data-library.yaml` files,
and creates a structured directory based on the tutorial names and file contents.

### Key Features:
- **Automated Data Download**: The script finds `data-library.yaml` files in the GTN repository and downloads the associated data files.
- **Structured Organization**: It creates directories based on the tutorial names and the information in the `data-library.yaml` files, so the files are organized.
- **Download Summary**: It generates a `download-summary.tsv` file, which includes metadata about the downloaded files, a download report (error, success, already downloaded), and the overall size of the files.

## Seamless Integration with Onedata

In addition to local downloads, the GTN Downloader can upload data to [Onedata](https://onedata.org), a distributed data management platform. This integration ensures that the latest GTN data is always available to users.

### Automated Workflow with GitHub CI/CD:
- **Automated Workflow**: A GitHub Actions workflow runs once a week on weekends to download the latest data from the GTN tutorials and upload it to Onedata.
- **Environment Setup**: The workflow sets up necessary environment variables and installs dependencies, including Oneclient, the Onedata POSIX client.
- **Data Upload**: After downloading the data, the workflow uploads it to Onedata, making it publicly accessible.
Binary file added news/images/galaxy-data-upload.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 747daa9

Please sign in to comment.