Skip to content

aequitas/concourse-ftp-resource

Repository files navigation

Docker Automated build Docker Automated build Docker Automated build Cyberveiligheid

FTP Resource

Concourse resource to interact with FTP servers.

https://hub.docker.com/r/aequitas/ftp-resource/

Recent changes

  • 06-2018: Handle missing previous versions (#8)
  • 01-2018: added support for semver versions.

Deploying to Concourse

No changes are necessary to BOSH configuration. However, you must define the FTP resource in a resource_types as can be seen in the below example pipeline.

Source Configuration

  • uri: Required. The URI for the FTP server (including path). Example: ftp://user:[email protected]/team/prod/

  • regex: Required. Python regex to match filenames to. Supports capture groups. Requires at least one capture group named version. Other groups are added as metadata.

  • version_key: Optional Alternative key to be used for the version capture group (default version).

  • debug: Optional Set debug logging of scripts, takes boolean (default true).

Behavior

check: Return list of file versions.

Will request a list of files from the uri and filter on matching regex extracting the version_key and returning list of versions captured groups.

in: Retrieve file matching version from ftp.

Uses the regex to compose a list of files and versions, will return the one file that matches the version provided in params.

Parameters

  • version: Required The version to return (will be matched against the version regex capture group).

out: Upload file(s) matching file glob to ftp.

Uploads a file(s) glob matching file to the ftp directory specified by uri.

  • file: Glob used to determine files to upload from src dir (default *).

  • keep_versions: If specified determined the amount of files to keep, deleting the old versions (default null). Requires a regex capture group named file to work.

Parameters

  • file: Required. Glob pattern to specify which files need to be uploaded.

Example pipeline

resource_types:
  - name: ftp
    type: docker-image
    source:
      repository: aequitas/ftp-resource

resources:
  - name: ftpupload
    type: ftp
    source:
      regex: (?P<file>test(?P<version>[0-9\.]+).*\.txt)
      uri: ftp://user:[email protected]:21/team/prod/

jobs:
  - name: testftp
    plan:
      - task: touchfile
        config:
          platform: linux
          run:
            path: sh
            args:
            - -exc
            - |
              touch test/test1.txt
          outputs:
          - name: test
      - put: ftpupload
        params:
          file: test/test1.txt

About

Concourse resource to interact with FTP servers.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published