Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/davivcgarcia/ubi-gogs
Unofficial image for Gogs based on Red Hat Universal Base Image
https://github.com/davivcgarcia/ubi-gogs
container docker gogs kubernetes openshift podman quay redhat ubi
Last synced: about 2 months ago
JSON representation
Unofficial image for Gogs based on Red Hat Universal Base Image
- Host: GitHub
- URL: https://github.com/davivcgarcia/ubi-gogs
- Owner: davivcgarcia
- License: unlicense
- Created: 2020-03-20T13:45:45.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2020-03-31T15:23:15.000Z (over 4 years ago)
- Last Synced: 2024-07-08T21:03:15.898Z (3 months ago)
- Topics: container, docker, gogs, kubernetes, openshift, podman, quay, redhat, ubi
- Language: Dockerfile
- Homepage:
- Size: 25.4 KB
- Stars: 3
- Watchers: 3
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# ubi-gogs
[](https://quay.io/repository/davivcgarcia/ubi-gogs)
Unofficial image for Gogs based on Red Hat Universal Base Image v8
## Why another image?
This image was build using the [Red Hat Universal Base Image (UBI) 8](https://developers.redhat.com/products/rhel/ubi/), which provides a stable foundation to workloads running on mission-critical environments, specially on **Red Hat OpenShift Container Platform**.
## How to use?
If you running standalone containers, you can use `podman` or `docker` with:
```bash
podman run -d -p 3000:3000 -p 3022:3022 quay.io/davivcgarcia/ubi-gogs
```
If you running containers on OpenShift (or Kubernetes using Ingress instead of Router API), and have dynamic provisioning enabled, you can use `kubectl` or `oc` to deploy it redirectly from this repo:
```bash
oc new-project gogs
oc apply -f https://github.com/davivcgarcia/ubi-gogs/releases/latest/download/openshift-resources.yaml
```
If you don't have dynamic provisioning for PersistentVolumes enabled, please create the required `PersistentVolume` resources and map them to the `PersistentVolumeClaim` resources before deployment.
## How to configure?
If you are running it on OpenShift/Kubernetes, you will notice that the resource template is configured to use container volumes at `/opt/gogs/data` and `/opt/gogs/custom`, mapped to `PersistentVolumes`. You need to use the path `/opt/gogs/data` to configure Gogs to store its repositories data. You could use it to persists logs too, but the recomendation is to enable console output.
The container can run using any unprivileged user ID, which will be mapped automaticaly to user `gogs` and used to run the application. So configure to use this user instead of the default `git`.
By default, the container will be listening internally on port `tcp/3000`, so do not change it when configuring. You could also enable native SSH service, using internal port `tcp/3022`. When using standalone containers, map these ports to available local ports. If you are running containers on Kubernetes/OpenShift, you can use Ingress/Routes exposed as `tcp/80 (HTTP)` or `tcp/443 (HTTPS)` redirecting to `tcp/3000` (mechanism is created by default) and Service type NodePort/LoadBalancer for `tcp/3022` (need manual setup).
Also, you could use `SQLite` as database, storing the file at `/opt/gogs/data`. But the prefered way is to setup a PostgreSQL database and use it instead.
## Any support?
This is a community project, not backed nor supported by Red Hat.