{"id":39076979,"url":"https://github.com/cloud-gov/s3-simple-resource","last_synced_at":"2026-01-17T18:27:22.969Z","repository":{"id":38034891,"uuid":"53566327","full_name":"cloud-gov/s3-simple-resource","owner":"cloud-gov","description":"Concourse CI Resource for uploading files to S3","archived":false,"fork":false,"pushed_at":"2025-05-22T22:50:18.000Z","size":84,"stargazers_count":31,"open_issues_count":17,"forks_count":75,"subscribers_count":57,"default_branch":"main","last_synced_at":"2025-05-22T23:27:12.688Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/18fgsa/s3-resource-simple/","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cloud-gov.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2016-03-10T08:02:36.000Z","updated_at":"2025-05-22T22:50:21.000Z","dependencies_parsed_at":"2023-02-03T10:00:26.415Z","dependency_job_id":"58582ca1-2aab-46ba-8f39-e2e0b8ff0df8","html_url":"https://github.com/cloud-gov/s3-simple-resource","commit_stats":null,"previous_names":["cloud-gov/s3-simple-resource","cloud-gov/s3-resource-simple"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/cloud-gov/s3-simple-resource","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloud-gov%2Fs3-simple-resource","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloud-gov%2Fs3-simple-resource/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloud-gov%2Fs3-simple-resource/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloud-gov%2Fs3-simple-resource/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cloud-gov","download_url":"https://codeload.github.com/cloud-gov/s3-simple-resource/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloud-gov%2Fs3-simple-resource/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28515490,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-17T17:57:59.192Z","status":"ssl_error","status_checked_at":"2026-01-17T17:57:52.527Z","response_time":85,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":[],"created_at":"2026-01-17T18:27:22.354Z","updated_at":"2026-01-17T18:27:22.956Z","avatar_url":"https://github.com/cloud-gov.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Simple S3 Resource for [Concourse CI](http://concourse.ci)\n\nResource to upload files to S3. Unlike the [the official S3 Resource](https://github.com/concourse/s3-resource), this Resource can upload or download multiple files.\n\n## Usage\n\nInclude the following in your Pipeline YAML file, replacing the values in the angle brackets (`\u003c \u003e`):\n\n```yaml\nresource_types:\n  - name: \u003cresource type name\u003e\n    type: registry-image\n    source:\n      aws_access_key_id: ((ecr_aws_key))\n      aws_secret_access_key: ((ecr_aws_secret))\n      repository: s3-resource-simple\n      aws_region: ((aws_region))\n      tag: ((tag))\nresources:\n  - name: \u003cresource name\u003e\n    type: \u003cresource type name\u003e\n    source:\n      access_key_id: { { aws-access-key } }\n      secret_access_key: { { aws-secret-key } }\n      bucket: { { aws-bucket } }\n      path:\n        [\n          \u003coptional\u003e,\n          use to sync to a specific path of the bucket instead of root of bucket,\n        ]\n      change_dir_to: [\u003coptional, see note below\u003e]\n      options: [\u003coptional, see note below\u003e]\n      region: \u003coptional, see below\u003e\njobs:\n  - name: \u003cjob name\u003e\n    plan:\n      - \u003csome Resource or Task that outputs files\u003e\n      - put: \u003cresource name\u003e\n```\n\n## AWS Credentials\n\nThe `access_key_id` and `secret_access_key` are optional and if not provided the EC2 Metadata service will be queried for role based credentials.\n\n## change_dir_to\n\nThe `change_dir_to` flag lets you upload the contents of a sub-directory without including the directory name as a prefix in your bucket.\nGiven the following directory `test`:\n\n```\ntest\n├── 1.json\n└── 2.json\n```\n\nand the config:\n\n```\n- name: test\n  type: s3-resource-simple\n  source:\n    change_dir_to: test\n    bucket: my-bucket\n    [...other settings...]\n```\n\n`put` will upload 1.json and 2.json to the root of the bucket. By contrast, with `change_dir_to` set to `false` (the default), 1.json and 2.json will be uploaded as `test/1.json` and `test/2.json`, respectively.\nThis flag has no effect on `get` or `check`.\n\n## Options\n\nThe `options` parameter is synonymous with the options that `aws cli` accepts for `sync`. Please see [S3 Sync Options](http://docs.aws.amazon.com/cli/latest/reference/s3/sync.html#options) and pay special attention to the [Use of Exclude and Include Filters](http://docs.aws.amazon.com/cli/latest/reference/s3/index.html#use-of-exclude-and-include-filters).\n\nGiven the following directory `test`:\n\n```\ntest\n├── results\n│   ├── 1.json\n│   └── 2.json\n└── scripts\n    └── bad.sh\n```\n\nwe can upload _only_ the `results` subdirectory by using the following `options` in our task configuration:\n\n```yaml\noptions:\n  - \"--exclude '*'\"\n  - \"--include 'results/*'\"\n```\n\n### Region\n\nInteracting with some AWS regions (like London) requires AWS Signature Version 4. This options allows you to explicitly specify region where your bucket is\nlocated (if this is set, AWS_DEFAULT_REGION env variable will be set accordingly).\n\n```yaml\nregion: eu-west-2\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloud-gov%2Fs3-simple-resource","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcloud-gov%2Fs3-simple-resource","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloud-gov%2Fs3-simple-resource/lists"}