{ "info": { "author": "Vokal", "author_email": "pypi@vokal.io", "bugtrack_url": null, "classifiers": [ "Development Status :: 2 - Pre-Alpha", "License :: OSI Approved :: MIT License", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3" ], "description": "s3same\n======\n\n``s3same`` (\"sesame\", like `\"open\nsesame\" `__) creates\nunique-per-repo AWS credentials for Travis CI artifact uploading to S3\nand encrypts those credentials with the repo's public key.\n\nInstallation\n------------\n\nRunning the command\n\n.. code:: sh\n\n sudo pip install s3same\n\nwill install the latest stable release of ``s3same`` as a command in\n``/usr/local/bin``.\n\nUsage\n-----\n\n::\n\n $ s3same --help\n Usage: s3same [OPTIONS] REPO\n\n Options:\n --pro Use Travis CI Pro\n --github TEXT GitHub token\n --owner TEXT GitHub owner\n --s3-bucket TEXT S3 bucket for artifacts\n --aws-region TEXT AWS region\n --aws-key TEXT AWS key\n --aws-secret TEXT AWS secret\n --aws-profile TEXT AWS profile\n --nuke Nuke the entire s3same setup on IAM\n --help Show this message and exit.\n\nLet's assume you've got your AWS credentials in\n```~/.aws/credentials`` `__.\nGo to your GitHub settings and `create a personal access\ntoken `__ for ``s3same`` (the\ntoken must have the ``repo`` permission). Create ``~/.s3same`` with:\n\n::\n\n GITHUB_TOKEN=put your token here\n S3_BUCKET=the bucket to which artifacts will be uploaded\n AWS_PROFILE=some profile\n AWS_REGION=your AWS region\n\nIf your AWS credentials are in the default profile, you can omit the\n``AWS_PROFILE`` line.\n\nWith all the credentials in place, running\n\n::\n\n $ s3same some-repo-name --owner some-user --pro\n\nwill create an AWS IAM user unique to the repo\n(``s3same_travis__some-user__some-repo-name``), add that user to the\n``s3same_travis`` AWS IAM group (creating the group if it doesn't exist)\nto give it the necessary permissions (defined by the ``s3same_travis``\npolicy, which will be created if it doesn't exist), generate an AWS key\nand secret for that user, use the public key for the given repo on\nTravis CI to encrypt the key and secret, and print out the YAML snippet\nto use for artifact uploading credentials.\n\nConfiguration\n-------------\n\nSeveral configuration parameters can be specified by the environment, in\nthe ``~/.s3same`` file, or on the command line. The name/syntax for\nenvironment variables and within the ``~/.s3same`` file are the same.\nAnything in the ``~/.s3same`` file overrides the corresponding\nenvironment variable and anything passed as a command-line parameter\noverrides the environment variables and the ``~/.s3same`` file. Setting\nan AWS key/secret pair overrides specifying an AWS configuration\nprofile.\n\n+----------------+-----------------------------+---------------------+\n| Parameter | Variable Name | Command-Line |\n+================+=============================+=====================+\n| GitHub Token | ``GITHUB_TOKEN`` | ``--github`` |\n+----------------+-----------------------------+---------------------+\n| GitHub Owner | ``GITHUB_OWNER`` | ``--owner`` |\n+----------------+-----------------------------+---------------------+\n| S3 Bucket | ``S3_BUCKET`` | ``--s3-bucket`` |\n+----------------+-----------------------------+---------------------+\n| AWS Region | ``AWS_REGION`` | ``--aws-region`` |\n+----------------+-----------------------------+---------------------+\n| AWS Key | ``AWS_ACCESS_KEY_ID`` | ``--aws-key`` |\n+----------------+-----------------------------+---------------------+\n| AWS Secret | ``AWS_SECRET_ACCESS_KEY`` | ``--aws-secret`` |\n+----------------+-----------------------------+---------------------+\n| AWS Profile | ``AWS_PROFILE`` | ``--aws-profile`` |\n+----------------+-----------------------------+---------------------+", "description_content_type": null, "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://github.com/vokal/s3same", "keywords": "travis ci s3 artifact", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "s3same", "package_url": "https://pypi.org/project/s3same/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/s3same/", "project_urls": { "Homepage": "http://github.com/vokal/s3same" }, "release_url": "https://pypi.org/project/s3same/0.1/", "requires_dist": null, "requires_python": "", "summary": "Configure Travis-CI artifact uploading to S3", "version": "0.1" }, "last_serial": 1988530, "releases": { "0.1": [ { "comment_text": "", "digests": { "md5": "38923969df0390e430a9ec28d7a81f93", "sha256": "b5187d189292e189051d1c4fb5868968274b6a6c5d380c861ef52a8a45961463" }, "downloads": -1, "filename": "s3same-0.1-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "38923969df0390e430a9ec28d7a81f93", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 8629, "upload_time": "2016-03-04T00:06:06", "url": "https://files.pythonhosted.org/packages/7e/a2/a7ed5bd1222ab9223d881e655e874609a1a01de9ba0de483f2b5dbb223b1/s3same-0.1-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "51f743900ff1879273dd4ddd8d6a47e0", "sha256": "4c9f3c726c3ed03de711b9ca35e691b80560102cd525b192996bb817cfa05931" }, "downloads": -1, "filename": "s3same-0.1.tar.gz", "has_sig": false, "md5_digest": "51f743900ff1879273dd4ddd8d6a47e0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6708, "upload_time": "2016-03-04T00:06:17", "url": "https://files.pythonhosted.org/packages/89/0d/d16597dc756cf50d6d782eb9c967f0cb51a8bb8fee6a67abab0e99a7e90d/s3same-0.1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "38923969df0390e430a9ec28d7a81f93", "sha256": "b5187d189292e189051d1c4fb5868968274b6a6c5d380c861ef52a8a45961463" }, "downloads": -1, "filename": "s3same-0.1-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "38923969df0390e430a9ec28d7a81f93", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 8629, "upload_time": "2016-03-04T00:06:06", "url": "https://files.pythonhosted.org/packages/7e/a2/a7ed5bd1222ab9223d881e655e874609a1a01de9ba0de483f2b5dbb223b1/s3same-0.1-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "51f743900ff1879273dd4ddd8d6a47e0", "sha256": "4c9f3c726c3ed03de711b9ca35e691b80560102cd525b192996bb817cfa05931" }, "downloads": -1, "filename": "s3same-0.1.tar.gz", "has_sig": false, "md5_digest": "51f743900ff1879273dd4ddd8d6a47e0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6708, "upload_time": "2016-03-04T00:06:17", "url": "https://files.pythonhosted.org/packages/89/0d/d16597dc756cf50d6d782eb9c967f0cb51a8bb8fee6a67abab0e99a7e90d/s3same-0.1.tar.gz" } ] }