ahmet2mir/us3

•Updated over 10 years ago

us3 helps you to manage files on AWS S3 or S3 compatible API like Ceph or Cleversafe.

Image

1.8K

ahmet2mir/us3 repository overview

           _____ 
 _   _ ___|___ / 
| | | / __| |_ \ 
| |_| \__ \___) |
 \__,_|___/____/

us3 helps you to manage files on AWS S3 or S3 compatible API like Ceph or Cleversafe. Useful with Continuous Integration pipelines :)

⁠Installation

pip install us3

For Docker check bottom

⁠Usage

us3 (upload|download) [options] -s <src>
us3 delete [options] -s <src>

⁠Options

-h --help                                   Show this screen.
--version                                   Show version.
-a <access> --access=<access>               Access key.
-x <secret> --secret=<secret>               Secret key.
-e <endpoint> --endpoint=<endpoint>         Host to connect to. Default 
                                            is s3.amazonaws.com. You can check all AWS host/region on 
                                            http://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region
-i <is_secure> --is_secure=<is_secure>      Use secure connection (https) 
                                            or not (http). Default is True.
-k <clg> --calling_format=<clg>             Choose how to call the S3 API. 
                                            Allowed:
                                            - SubdomainCallingFormat (default)
                                            - VHostCallingFormat
                                            - OrdinaryCallingFormat 
                                            - ProtocolIndependentOrdinaryCallingFormat.
-b <bucket> --bucket=<bucket>               Bucket name.
-s <src> --source=<src>                     File to download/upload.
-d <dest> --destination=<dest>               Destination folder path.
-c <config.yml> --config=<config.yml>       Config file path.

Thoses values are overrided by environment variables.

Config file


You could use a config file in ``YAML`` format to reduce options in CLI.

By default, ``us3`` will look at ``/etc/default/us3.yaml`` or to the
custom path with ``--config <pathtoconf>``.

**Thoses values are overrided by the CLI and environment variables.**

Example:

::

    $ cat /etc/default/us3.yaml
    ---
    host:  mycustomhost
    access: myaccesskey
    secret: mysecurekey
    calling_format: OrdinaryCallingFormat
    is_secure: False

Environment variables

Environment variables had priority on config values and CLI values. To export a value, prepend variable name uppered with US3_.

Example:

export US3_HOST= myexporthost
export US3_ACCESS=myaccesskey
export US3_SECRET=mysecurekey

⁠Docker

Image size ~70MB

docker pull ahmet2mir/us3

And use environment variables. By default, files are stored in /data

docker run --rm \
    -e "US3_ENDPOINT=s3-eu-west-1.amazonaws.com" \
    -e 'US3_BUCKET=xxxx' \
    -e 'US3_ACCESS=yyyy' \
    -e 'US3_SECRET=zzzz+' \
    -v /tmp/docker:/data \
    ahmet2mir/us3 download -s myfile

⁠Licence

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0⁠

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Tag summary

Recent tags

Content type

Image

Digest

Size

21.2 MB

Last updated

over 10 years ago

docker pull ahmet2mir/us3