mirror of
https://github.com/YunoHost-Apps/minio_ynh.git
synced 2024-09-03 19:46:18 +02:00
75 lines
3.4 KiB
Markdown
75 lines
3.4 KiB
Markdown
<!--
|
||
Nota bene : ce README est automatiquement généré par <https://github.com/YunoHost/apps/tree/master/tools/readme_generator>
|
||
Il NE doit PAS être modifié à la main.
|
||
-->
|
||
|
||
# MinIO server pour YunoHost
|
||
|
||
[](https://dash.yunohost.org/appci/app/minio)  
|
||
|
||
[](https://install-app.yunohost.org/?app=minio)
|
||
|
||
*[Lire le README dans d'autres langues.](./ALL_README.md)*
|
||
|
||
> *Ce package vous permet d’installer MinIO server rapidement et simplement sur un serveur YunoHost.*
|
||
> *Si vous n’avez pas YunoHost, consultez [ce guide](https://yunohost.org/install) pour savoir comment l’installer et en profiter.*
|
||
|
||
## Vue d’ensemble
|
||
|
||
MinIO is a High Performance Object Storage released under GNU Affero General Public License v3.0. It is API compatible with Amazon S3 cloud storage service. Use MinIO to build high performance infrastructure for machine learning, analytics and application data workloads.
|
||
|
||
## How to create a YunoHost app using MinIO
|
||
During the install process, MinIO will install both the MinIO server and MinIO client.
|
||
If your app needs to use an Amazon S3 storage, I recommend to use the MinIO client to create and setup buckets as per your app's requirements. You can have a look at outline_ynh app for reference.
|
||
|
||
### First step: retrieve MinIO credentials
|
||
```
|
||
#=================================================
|
||
# SETUP MINIO CREDENTIALS
|
||
#=================================================
|
||
minio_domain=$(ynh_app_setting_get --app="minio" --key=domain)
|
||
minio_admin=$(ynh_app_setting_get --app="minio" --key=admin)
|
||
minio_password=$(ynh_app_setting_get --app="minio" --key=password)
|
||
mc_path=$(ynh_app_setting_get --app="minio" --key=mc_path)
|
||
```
|
||
|
||
### Second step: create and setup your bucket
|
||
```
|
||
#=================================================
|
||
# SETUP MINIO BUCKET
|
||
#=================================================
|
||
ynh_script_progression --message="Setting up MinIO bucket for YOURAPP..." --weight=1
|
||
|
||
pushd "$mc_path"
|
||
ynh_exec_warn_less sudo -u minio ./mc mb minio/NAME_OF_YOUR_BUCKET --region "NAME_OF_YOUR_REGION"
|
||
ynh_exec_warn_less sudo -u minio ./mc policy set NEEDED_POLICY minio/NAME_OF_YOUR_BUCKET
|
||
popd
|
||
```
|
||
|
||
**Version incluse :** 2023.09.07~ynh2
|
||
|
||
## Captures d’écran
|
||
|
||
|
||
|
||
## Documentations et ressources
|
||
|
||
- Site officiel de l’app : <https://min.io>
|
||
- Documentation officielle de l’admin : <https://docs.min.io/>
|
||
- Dépôt de code officiel de l’app : <https://github.com/minio/minio>
|
||
- YunoHost Store : <https://apps.yunohost.org/app/minio>
|
||
- Signaler un bug : <https://github.com/YunoHost-Apps/minio_ynh/issues>
|
||
|
||
## Informations pour les développeurs
|
||
|
||
Merci de faire vos pull request sur la [branche `testing`](https://github.com/YunoHost-Apps/minio_ynh/tree/testing).
|
||
|
||
Pour essayer la branche `testing`, procédez comme suit :
|
||
|
||
```bash
|
||
sudo yunohost app install https://github.com/YunoHost-Apps/minio_ynh/tree/testing --debug
|
||
ou
|
||
sudo yunohost app upgrade minio -u https://github.com/YunoHost-Apps/minio_ynh/tree/testing --debug
|
||
```
|
||
|
||
**Plus d’infos sur le packaging d’applications :** <https://yunohost.org/packaging_apps>
|