Skip to content

Commit

Permalink
chore: Removes documentation from README and link to docs on Charmhub…
Browse files Browse the repository at this point in the history
… instead (#56)
  • Loading branch information
saltiyazan committed Feb 26, 2024
1 parent 2549aeb commit 211d902
Show file tree
Hide file tree
Showing 3 changed files with 6 additions and 57 deletions.
55 changes: 2 additions & 53 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,60 +3,9 @@

LEGO operator implementing the provider side of the `tls-certificates`
interface to get signed certificates from the `Let's Encrypt` ACME server
using the HTTP Request plugin for DNS-01 challenge.
using the HTTP Request plugin of the LEGO client and the DNS-01 challenge.

# Pre-requisites

This charm is a provider of the [`tls-certificates-interface`](https://github.com/canonical/tls-certificates-interface),
charms that require Let's Encrypt certificates need to implement the requirer side.

This operator targets a custom implementation of an API defined in
[`go-acme lego documentation`](https://go-acme.github.io/lego/dns/httpreq/).
This custom API needs be implemented for you particular use case and its URL
provided to as a configuration to this operator.

## Usage

Create a YAML configuration file with the following fields:

```yaml
httprequest-lego-k8s:
email: <Account email address>
httpreq_endpoint: <HTTP/HTTPS URL>
```
Deploy `httprequest-lego-k8s`:

```bash
juju deploy httprequest-lego-k8s --config <yaml config file>
```

Relate it to a `tls-certificates-requirer` charm:

```bash
juju relate httprequest-lego-k8s:certificates <tls-certificates-requirer>
````
## Config
### Required configuration properties
- email: Let's Encrypt email address
- httpreq_endpoint: HTTP/HTTPS URL to the service implementing the HTTPREQ API
### Optional configuration properties
- server: Let's Encrypt server to use (default: `https://acme-v02.api.letsencrypt.org/directory`)
- httpreq_http_timeout: API request timeout
- httpreq_mode: "'RAW' or None"
- httpreq_password: Basic authentication password
- httpreq_polling_interval: Time between DNS propagation checks
- httpreq_propagation_timeout: Maximum waiting time for DNS propagation
- httpreq_username: Basic authentication username

## Relations

- `certificates`: `tls-certificates-interface` provider
For more information including guides, integrations, configuration options, see [HTTP Request LEGO's Charmhub page](https://charmhub.io/httprequest-lego-k8s).

## OCI Images

Expand Down
4 changes: 2 additions & 2 deletions config.yaml
Original file line number Diff line number Diff line change
@@ -1,14 +1,14 @@
options:
email:
type: string
description: Account email address
description: Account email address, this email will receive notifications from Let's Encrypt.
server:
type: string
description: Certificate authority server
default: "https://acme-v02.api.letsencrypt.org/directory"
httpreq_endpoint:
type: string
description: URL of the HTTP endpoint to use
description: URL of the custom API that can be used to fulfill the DNS-01 challenge
httpreq_http_timeout:
type: int
description: API request timeout
Expand Down
4 changes: 2 additions & 2 deletions metadata.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -8,11 +8,11 @@ display-name: HTTP Request LEGO (K8s)
description: |
LEGO operator implementing the provider side of the `tls-certificates`
interface to get signed certificates from the `Let's Encrypt` ACME server
using the HTTP Request plugin for DNS-01 challenge.
using the HTTP Request plugin of the LEGO client and the DNS-01 challenge.
summary: |
LEGO operator implementing the provider side of the `tls-certificates`
interface to get signed certificates from the `Let's Encrypt` ACME server
using the HTTP Request plugin for DNS-01 challenge.
using the HTTP Request plugin of the LEGO client and the DNS-01 challenge.
website: https://charmhub.io/httprequest-lego-k8s
source: https://github.com/canonical/httprequest-lego-k8s-operator
issues: https://github.com/canonical/httprequest-lego-k8s-operator/issues
Expand Down

0 comments on commit 211d902

Please sign in to comment.