{"id":13748590,"url":"https://github.com/jenkinsci/s3-plugin","last_synced_at":"2025-05-09T11:30:56.692Z","repository":{"id":1237628,"uuid":"1175683","full_name":"jenkinsci/s3-plugin","owner":"jenkinsci","description":"Upload Jenkins build artifacts to Amazon S3","archived":false,"fork":true,"pushed_at":"2024-08-06T20:28:39.000Z","size":10620,"stargazers_count":112,"open_issues_count":15,"forks_count":193,"subscribers_count":108,"default_branch":"master","last_synced_at":"2024-08-25T00:42:40.894Z","etag":null,"topics":["aws","java","jenkins-plugin","s3"],"latest_commit_sha":null,"homepage":"https://plugins.jenkins.io/s3/","language":"Java","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"d6y/hudson-s3","license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jenkinsci.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2010-12-16T23:28:08.000Z","updated_at":"2024-08-06T20:28:41.000Z","dependencies_parsed_at":"2023-09-22T17:34:17.244Z","dependency_job_id":null,"html_url":"https://github.com/jenkinsci/s3-plugin","commit_stats":null,"previous_names":[],"tags_count":47,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jenkinsci%2Fs3-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jenkinsci%2Fs3-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jenkinsci%2Fs3-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jenkinsci%2Fs3-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jenkinsci","download_url":"https://codeload.github.com/jenkinsci/s3-plugin/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224859699,"owners_count":17381676,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aws","java","jenkins-plugin","s3"],"created_at":"2024-08-03T07:00:44.866Z","updated_at":"2024-11-15T23:30:29.331Z","avatar_url":"https://github.com/jenkinsci.png","language":"Java","readme":"\nThis plugin helps one to upload build artifacts to Amazon S3.\n\n## Making artifacts public\n\nIf you'd like to have some of your artifacts be publicly downloadable,\nsee [Granting public access to some S3 objects](https://aws.amazon.com/premiumsupport/knowledge-center/read-access-objects-s3-bucket/)\n\nUsage\n=====\n\nWhen activated, traditional (Freestyle) Jenkins builds will have a\nbuild action called `S3 Copy Artifact` for downloading artifacts,\nand a post-build action called `Publish Artifacts to S3 Bucket`.\n\nFor Pipeline users, the same two actions are available via the\n`s3CopyArtifact` and `s3Upload` step. You can use the snippet generator to get started.\n\nWhen using an Amazon S3 compatible storage system (OpenStack Swift, EMC Atmos...),\nthe list of AWS regions can be overridden by specifying a file \n`classpath://com/amazonaws/partitions/override/endpoints.json` matching the format \ndefined in AWS SDK's [endpoints.json](https://github.com/aws/aws-sdk-java/blob/master/aws-java-sdk-core/src/main/resources/com/amazonaws/partitions/endpoints.json).\n\nA solution to add this `endpoints.json` file in the classpath of Jenkins is to use the \n`java` command line parameter `-Xbootclasspath/a:/path/to/boot/classpath/folder/` and \nto locate `com/amazonaws/partitions/override/endpoints.json` in `/path/to/boot/classpath/folder/`.\n\n\nEven if most of the features of the Jenkins S3 Plugin require the user to specify the target region,\nsome feature rely on a default Amazon S3 region which is by default the \"US Standard Amazon S3 Region\" \nand its endpoint is `s3.amazonaws.com`. This default region can be overridden with the system property \n`hudson.plugins.s3.DEFAULT_AMAZON_S3_REGION`. \nNote that this default region name MUST match with a region define in the AWS SDK configuration file `endpoints.json`\n(see above).\n\nUsage with IAM\n=====\n\nIf you used IAM to create a separate pair of access credentials for this\nplugin, you can lock down its AWS access to simply listing buckets and\nwriting to a specific bucket. Add the following custom policy to the\nuser in the IAM console, replacing occurrences of \"my-artifact-bucket\"\nwith your bucket name, which you'll have to create first:\n\n``` json\n{\n  \"Statement\": [\n    {\n      \"Action\": [\n        \"s3:ListAllMyBuckets\"\n      ],\n      \"Effect\": \"Allow\",\n      \"Resource\": \"arn:aws:s3:::*\"\n    },\n    {\n      \"Action\": \"s3:*\",\n      \"Effect\": \"Allow\",\n      \"Resource\": [\"arn:aws:s3:::my-artifact-bucket\", \"arn:aws:s3:::my-artifact-bucket/*\"]\n    }\n  ]\n}\n```\n\nNotes\n=====\n\n* Only the basename of source files is used as the object key name,\nan option to include the path name relative to the workspace\nshould probably be added.\n\nChangelog\n=========\n\n* New change logs are in [GitHub Releases](https://github.com/jenkinsci/s3-plugin/releases)\n* Old change logs are stored in [old-changelog.md](old-changelog.md).\n\nAcknowledgements\n================\n\n* The Hudson scp plugin author for providing a great place to\nstart copy/pasting from.\n* http://github.com/stephenh/hudson-git2 - for this README.markdown\ntemplate and a great git plugin for hudson.\n* jets3t - http://jets3t.s3.amazonaws.com/index.html\n","funding_links":[],"categories":["Java"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjenkinsci%2Fs3-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjenkinsci%2Fs3-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjenkinsci%2Fs3-plugin/lists"}