HTTP(S)
The HTTP(S) integration uses an HTTP or HTTPS endpoint as a Kloset store
backend. It is used to connect to a Kloset store exposed by plakar server.
The integration includes one connector:
| Connector type | Description |
|---|---|
| Store connector | Host a Kloset store on any HTTP or HTTPS accessible endpoint. |
Requirements
- Plakar
v1.1.0or later. - An HTTP or HTTPS endpoint serving a Kloset store, for example one exposed by
plakar server.
Installation
The integration is pre-installed in Plakar v1.1.0 or later and requires no
additional setup.
Configuration
The store connector uses the http:// or https:// protocol. The location can
be given directly on the command line with either prefix, or registered as a
store alias.
When the endpoint requires a bearer token, for example a plakar server started
with -token, configure the store as an alias so the token is stored with it.
The token is then sent in the Authorization header on every request. Over
plaintext HTTP, the token is sent only when insecure=true is set.
Store configuration
| Option | Required | Description |
|---|---|---|
location |
Yes | URL of the HTTP or HTTPS endpoint, for example http://example.com/data. |
auth_token |
No | Bearer token sent in the Authorization header on every request. |
insecure |
No | Set to true to allow auth_token to be sent over plaintext HTTP. |
timeout |
No | Per-request timeout. Defaults to 5m. |
tls_no_verify |
No | Set to true to disable TLS certificate verification over HTTPS. |
Example
Initialize a store at an HTTP endpoint, back up a local directory to it, and list its snapshots:
# Initialize a Kloset store at the HTTP endpoint
$ plakar at http://example.com/data create
# Back up a local directory to the store
$ plakar at http://example.com/data backup /var/www
# List snapshots in the store
$ plakar at http://example.com/data lsRegister an endpoint that requires a bearer token:
# Register the endpoint along with its token
$ plakar store add remote https://example.com/data auth_token=<token>
# Use the alias, the token is sent on every request
$ plakar at @remote ls