Compare commits
8 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| d7678274be | |||
| 4a8f7525e7 | |||
| fb55f47e5c | |||
| 0251b9dc69 | |||
| 2b505b0d9d | |||
| cb3545f261 | |||
| d673b97b4b | |||
| 1be4aeb6b8 |
15
README.md
15
README.md
@@ -1,6 +1,6 @@
|
||||
# Web-Password
|
||||
|
||||
_a web based password generator_
|
||||
_a web based password generator, with an API endpoint_
|
||||
|
||||

|
||||
|
||||
@@ -16,7 +16,7 @@ There is a demo at [https://passwd.scu.si](https://passwd.scu.si)
|
||||
|
||||
## Usage
|
||||
|
||||
The follwoing example shows how to get up your own instance with `docker compose`.
|
||||
The following example shows how to get up your own instance with `docker compose`.
|
||||
|
||||
```
|
||||
git clone https://gitea.scu.si/FlorianWalther/Web-Password.git
|
||||
@@ -26,4 +26,15 @@ docker compose pull
|
||||
docker compose up -d
|
||||
```
|
||||
|
||||
## Docker image
|
||||
|
||||
The latest official docker image is at [https://gitea.scu.si/FlorianWalther/-/packages/container/password-generator/latest](https://gitea.scu.si/FlorianWalther/-/packages/container/password-generator/latest)
|
||||
|
||||
You can pull it like this:
|
||||
```
|
||||
docker pull gitea.scu.si/florianwalther/password-generator:latest
|
||||
```
|
||||
|
||||
## more usage examples
|
||||
|
||||
There are some more usage example in [misc/MoreUsage.md](misc/MoreUsage.md)
|
||||
|
||||
@@ -1,31 +1,60 @@
|
||||
## bash alias
|
||||
|
||||
You can configure an bash alias in your `~/.bashrc` like this:
|
||||
|
||||
# Baue die Go-Anwendung
|
||||
```
|
||||
## genpasswd alias
|
||||
alias genpasswd='echo $(curl -s https://passwd.scu.si/api/password)'
|
||||
```
|
||||
|
||||
After making above changes you have to reload your ~/bashrc, in order to activate your changes.
|
||||
```
|
||||
. ~/.bashrc
|
||||
```
|
||||
|
||||
Now you can enter `genpasswd` and get a fresh password from the API Endpoint.
|
||||
|
||||
# building the app
|
||||
|
||||
you can build the app yourself like this:
|
||||
|
||||
```
|
||||
go build -o password-generator ./
|
||||
```
|
||||
|
||||
# Baue das Docker-Image
|
||||
|
||||
|
||||
# build a docker container
|
||||
|
||||
```
|
||||
docker build -t password-generator .
|
||||
```
|
||||
|
||||
# Starte den Docker Container
|
||||
# start the docker container
|
||||
|
||||
```
|
||||
docker run -p 8080:8080 password-generator
|
||||
```
|
||||
|
||||
## mit docker-compose
|
||||
## docker-compose
|
||||
|
||||
Ein `docker-compose.yml` wird mitgeliefert.
|
||||
There are two example docker-compose files in the [misc](./) directory.
|
||||
|
||||
### docker-compose.yml
|
||||
|
||||
A basic variant that just brings up the container and export port 8080.
|
||||
The basic variant can be used without modifications.
|
||||
|
||||
### docker-compose.traefik.yml
|
||||
|
||||
The other one is meant to be used behind a traefik reverse proxy.
|
||||
This variant has lables to configure traefik accordingly.
|
||||
The traefik variant needs to be adjusted to your environment before
|
||||
you can use it successfully.
|
||||
|
||||
### initial pull
|
||||
|
||||
```
|
||||
docker compose login gitea.scu.si
|
||||
docker compose pull
|
||||
```
|
||||
|
||||
@@ -41,5 +70,13 @@ docker compose up -d
|
||||
docker compose down
|
||||
```
|
||||
|
||||
### update container
|
||||
|
||||
In order to update your container to the current version, do this:
|
||||
```
|
||||
docker compose pull
|
||||
docker compose down
|
||||
docker compose up -d
|
||||
```
|
||||
|
||||
|
||||
|
||||
@@ -5,8 +5,6 @@ services:
|
||||
restart: always
|
||||
expose:
|
||||
- "8080:8080"
|
||||
# Falls die Registry privat ist, muss der Host zuvor mit
|
||||
# 'docker login gitea.scu.si' angemeldet worden sein.
|
||||
labels:
|
||||
- "traefik.enable=true"
|
||||
- "traefik.docker.network=traefik_backend"
|
||||
|
||||
Reference in New Issue
Block a user