diff --git a/README.md b/README.md index 3c3c739..da709fd 100644 --- a/README.md +++ b/README.md @@ -57,9 +57,21 @@ authorize. A user can only manage uploads within that context. Think ## Installation -Since the software is currently being developed, there are no binary -releases available yet. You'll need a go build environment. Just run -`make` to build everything. +### Deploy server using pre-built docker file + +A ready to use ephemerup server image is available on +[ghcr.io](https://ghcr.io/tlinden/ephemerup). Supported tags are: +`latest` or a github release tag. + +To try it locally with docker: + +``` +docker run -dp 8080:8080 --name eph \ + ghcr.io/tlinden/ephemerup:latest \ + -LogLevel=info +``` + +### Build Dockerfile There's a `Dockerfile` available for the server so you can build and run it using docker: ``` @@ -68,6 +80,35 @@ docker-compose run ephemerup ``` Then use the client to test it. +### Install from binary package + +Go to the [Releases](https://github.com/TLINDEN/ephemerup/releases) +page and download the latest tarball for your platform. Unpack it and +execute `make install` inside the created directory. + +This installs both the server `ephemerupd` and the client `upctl`. + +If you only need the client, just grab the tarball and extract just +the client, copy it to your bin folder and you're good to go. + +### Deploy on Kubernetes using the Helm chart + +``` +helm repo add tlinden https://tlinden.github.io/ephemerup/ +helm repo update +helm upgrade --install ephemerup tlinden/ephemerup --namespace ephemerup --create-namespace +``` + +Refer to the [chart documentation](https://github.com/TLINDEN/ephemerup/tree/main/charts/ephemerup) for help. + +### Build from source + +To build from source, you'll need a go build environment. + +Clone the git repo +Just run `make` to build everything. + + ## Server Usage ``` diff --git a/charts/cm.yaml b/charts/cm.yaml deleted file mode 100644 index 3d62ae0..0000000 --- a/charts/cm.yaml +++ /dev/null @@ -1,24 +0,0 @@ -apiVersion: v1 -kind: ConfigMap -metadata: - name: eph-ephemerup-config - namespace: "eph" - labels: - app.kubernetes.io/name: ephemerup - helm.sh/chart: ephemerup-1.0.0 - app.kubernetes.io/instance: eph - app.kubernetes.io/managed-by: Helm - annotations: - app: ephemerup -data: - listen = "8080" - bodylimit = "1024" - super = "root" - mail = { - server = - port = - from = - password = - } - apicontexts = [ - ]