Downloads and tracks the update of a single URL-addressable file.
Tracks the update of a single URL-addressable file.
This is a useful resource for pipeline development time, while a required artifact is temporarily available from a URL-addressable location, until it is moved to a more robust file management repository such as [git](https://github.com/concourse/git-resource) or [S3](https://github.com/concourse/s3-resource).
This is a useful resource for pipeline development time, while a required artifact is temporarily available from a URL-addressable location, until it is moved to a more robust file management repository such as [git](https://github.com/concourse/git-resource) or [S3](https://github.com/concourse/s3-resource).
## Source Configuration
## Source Configuration
@ -36,9 +36,13 @@ resources:
### `check`: Check for the latest version of the file.
### `check`: Check for the latest version of the file.
The resource uses `curl` under-the-covers to post a GET request and retrieve the HTTP header info for the file URL provided.
The resource uses `curl` under-the-covers to post a GET request and retrieve the HTTP header info for the file URL provided.
If field `Last-Modified` is returned as part of the HTTP response header, then the resource will use that to build a version number timestamp with format "YYYYMMDDHHMMSS".
If field `Last-Modified` is returned as part of the HTTP response header, then the resource will use that to build a version number timestamp with format "YYYYMMDDHHMMSS".
Otherwise, the timestamp string will be built using the request's current time, which will result in a new version being returned every time `check` is executed for that file.
Otherwise, the timestamp string will be built using the request's current time, which will result in a new version being returned every time `check` is executed for that file.
To verify if a file URL returns the `Last-Modified` information in its HTTP response header, issue the `curl` command below and search for field "Last-Modified" in its output.
```curl -I <file-url>```
### `in`: Download the latest version of the file.
### `in`: Download the latest version of the file.
Downloads the latest version of the file issuing a `curl` command under-the-covers.
Downloads the latest version of the file issuing a `curl` command under-the-covers.