From 28af27e4d2eb2227e7734fa325958a0a00009d0c Mon Sep 17 00:00:00 2001 From: Milan <milan.danecek@gmail.com> Date: Tue, 8 Aug 2023 15:13:45 +0200 Subject: [PATCH] Add S3 service guide --- object-storage/s3-service.md | 21 +++++++++++++++++++-- 1 file changed, 19 insertions(+), 2 deletions(-) diff --git a/object-storage/s3-service.md b/object-storage/s3-service.md index aaab983..7bd3e0d 100644 --- a/object-storage/s3-service.md +++ b/object-storage/s3-service.md @@ -4,7 +4,24 @@ languages: - cs --- -# Object Storage +# S3 Service + +S3 service is a general service suited for most of the use cases. S3 service can be used for elementary data storing, automated backups, or various types of data handling applications. + +S3 service utilizes similar name convention as AWS S3. The convention is “bucket.domain.cz”. The tenant is the unique identificator and domain is s3.clX.du.cesnet.cz. If you will not explicitly mention the tenant it should be recognized automatically. The recognition is being performed based on the access key and secret key. So it should be sufficient to use the format as follows: s3.clX.du.cesnet.cz/bucket + +In case your client considers the endpoint as native AWS you have to switch to S3 compatible endpoint. Most of the clients can automatically process both formattings. However, in some cases is necessary to specify the format explicitly. + +**To connect to S3 service, you have to contact Data Storage support at: du-support@cesnet.cz** + +Once you obtain your credentials you can continue to connection itself using one of the following S3 client. + +## S3 service clients +In the following section you can find recommended S3 clients. + +### AWS-CLI (Linux, Windows) +[AWS CLI](https://aws.amazon.com/cli/) - Amazon Web Services Command Line Interface - is standardized too; supporting S3 interface. Using this tool you can handle your data and set up your S3 data storage. You can used the command line control or you can incorporate AWS CLI into your automated scripts. [Tutorial for AWS CLI](./object-storage/aws-cli). + + -Detail documentation for Object Storage services could be found at [du.cesnet.cz](https://du.cesnet.cz/en/navody/object_storage/start) -- GitLab