step.yml

title: |-
  S3 derived data Cache Pull
summary: |
  A step to retrieve your derived data from a S3 bucket using custom keys.

  This should be used with the s3-cache-push step to store the cache.

  If you want to retrieve multiple items, you'll need run this step multiple times.

  *Bucket Access*
  For this step to work you'll need an user in aws with programmatic access to a bucket.
  The user should have permissions to list, get, and put objects in the bucket.

  You can set the credentials using the Bitrise Secrets with the keys specified in the inputs
  or set them directly in the inputs.
website: https://github.com/alephao/bitrise-step-s3-cache-pull
source_code_url: https://github.com/alephao/bitrise-step-s3-cache-pull
support_url: https://github.com/alephao/bitrise-step-s3-cache-pull/issues
host_os_tags:
  - osx-10.10
  - ubuntu-16.04

type_tags:
  - utility

is_requires_admin_user: true
is_always_run: false
is_skippable: false
run_if: ""

toolkit:
  go:
    package_name: github.com/alephao/bitrise-step-s3-cache-pull

inputs:
  - cache_aws_access_key_id:
    opts:
      title: AWS_ACCESS_KEY_ID
      category: AWS Access
      summary: The AWS_ACCESS_KEY_ID to access the bucket.
      description: |
        The access key id that matches the secret access key.

        The credentials need to be from a user that has at least the following permissions
        in the bucket specified bellow `s3:ListObjects`, `s3:PutObject`, and `s3:GetObject`.
      is_expand: true
      is_required: true
      is_sensitive: true

  - cache_aws_secret_access_key:
    opts:
      title: AWS_SECRET_ACCESS_KEY
      category: AWS Access
      summary: The AWS_SECRET_ACCESS_KEY to access the bucket.
      description: |
        The secret access key that matches the access key id.

        The credentials need to be from a user that has at least the following permissions
        in the bucket specified bellow `s3:ListObjects`, `s3:PutObject`, and `s3:GetObject`.
      is_expand: true
      is_required: true
      is_sensitive: true

  - cache_aws_region:
    opts:
      title: AWS Region
      summary: The region of the S3 bucket
      category: AWS Bucket
      is_expand: true
      is_required: true
      value_options:
        - us-east-1
        - us-east-2
        - us-west-1
        - us-west-2
        - ca-central-1
        - eu-north-1
        - eu-west-3
        - eu-west-2
        - eu-west-1
        - eu-central-1
        - eu-south-1
        - ap-south-1
        - ap-northeast-1
        - ap-northeast-2
        - ap-northeast-3
        - ap-southeast-1
        - ap-southeast-2
        - ap-east-1
        - sa-east-1
        - cn-north-1
        - cn-northwest-1
        - us-gov-east-1
        - us-gov-west-1
        - us-gov-secret-1
        - us-gov-topsecret-1
        - me-south-1
        - af-south-1

  - cache_bucket_name:
    opts:
      title: Bucket Name
      category: AWS Bucket
      summary: The name of the s3 bucket where you want to store the cache
      is_expand: true
      is_required: true

  - cache_restore_keys:
    opts:
      title: Cache restore keys
      summary: List of cache key prefixes to find the cached file
      description: |
        The cache key is a string

        This step will loop through the specified keys and retrieve the cache for the first
        key that matches the prefix of a cache key. For example:

        If you only have a cache stored with the key `carthage-a-b-c` and the following restore Keys:

        cache_restore_keys: |
          carthage-a-b-123
          carthage-a-123
          carthage-
          car

        It will try looking for a key prefixed with `carthage-a-b-123` and will find nothing. Then
        it will try the same for `carthage-a-123` and will find nothing. Then it will try the same for
        `carthage-` and it will find our cache `carthage-a-b-c` and retrieve it.

        If a cache is not found for the key, this step is skipped.
      category: Cache
      is_expand: true
      is_required: true

  - cache_path:
    opts:
      title: Cache path
      summary: Path to download the file or directory cached. Relative to the root of the git repo.
      description: |
        If you stored the cache as `/path/to/my/folder`, the compressed file in the bucket will contain
        only `folder`, therefore you'll need to set this to `/path/to/my/`
      category: Cache
      is_expand: true
      is_required: true