rucio/rucio-init repository overview

⁠Rucio - Scientific Data Management

⁠(Init Container)

Rucio is a software framework that provides functionality to organize, manage, and access large volumes of scientific data using customisable policies. The data can be spread across globally distributed locations and across heterogeneous data centers, uniting different storage and network technologies as a single federated entity. Rucio offers advanced features such as distributed data recovery or adaptive replication, and is highly scalable, modular, and extensible. Rucio has been originally developed to meet the requirements of the high-energy physics experiment ATLAS, and is continuously extended to support LHC experiments and other diverse scientific communities.

⁠Documentation

General information and latest documentation about Rucio can be found at readthedocs⁠ or on our webpage⁠.

⁠Developers

For information on how to contribute to Rucio, please refer and follow our CONTRIBUTING⁠ guidelines.

⁠Getting Started

This image provides the tools needed to bootstrap the database. It creates the necessary tables and adds a root account with the configured identities. To initialize a MySQL DB running at mysql.db with a root account with userpass authentication you could use something like this:

docker run --rm \
  -e RUCIO_CFG_DATABASE_DEFAULT="mysql://rucio:[email protected]/rucio" \
  -e RUCIO_CFG_BOOTSTRAP_USERPASS_IDENTITY="ddmlab" \
  -e RUCIO_CFG_BOOTSTRAP_USERPASS_PWD="secret" \
  rucio/rucio-init

⁠RUCIO_CFG configuration parameters:

Environment variables can be used to set values for the auto-generated rucio.cfg. The names are derived from the actual names in the configuration file prefixed by RUCIO_CFG, e.g., the default value in the database section becomes RUCIO_CFG_DATABASE_DEFAULT. The available environment variables are:

• RUCIO_CFG_BOOTSTRAP_GSS_IDENTITY
• RUCIO_CFG_BOOTSTRAP_SAML_EMAIL
• RUCIO_CFG_BOOTSTRAP_SAML_ID
• RUCIO_CFG_BOOTSTRAP_SSH_IDENTITY
• RUCIO_CFG_BOOTSTRAP_USERPASS_EMAIL
• RUCIO_CFG_BOOTSTRAP_USERPASS_IDENTITY
• RUCIO_CFG_BOOTSTRAP_USERPASS_PWD
• RUCIO_CFG_BOOTSTRAP_X509_EMAIL
• RUCIO_CFG_BOOTSTRAP_X509_IDENTITY
• RUCIO_CFG_DATABASE_DEFAULT
• RUCIO_CFG_DATABASE_ECHO
• RUCIO_CFG_DATABASE_POOL_RECYCLE
• RUCIO_CFG_DATABASE_POOL_RESET_ON_RETURN
• RUCIO_CFG_DATABASE_SCHEMA
• RUCIO_CFG_GSS_BOOTSTRAP_EMAIL

⁠Getting Support

If you are looking for support, please contact our mailing list [email protected]⁠ or join us on our slack support⁠ channel.