An open API service indexing awesome lists of open source software.

https://github.com/thomas-illiet/k8s-guacamole

Apache Guacamole for Kubernetes
https://github.com/thomas-illiet/k8s-guacamole

guacamole kubernetes rdp remote-control ssh telnet vnc

Last synced: 6 months ago
JSON representation

Apache Guacamole for Kubernetes

Awesome Lists containing this project

README

          

# K8S Guacamole

![banner](meta/k8s-guacamole-banner.png)

[Apache Guacamole](https://guacamole.apache.org/releases/1.1.0/) 1.1.0 is a clientless HTML5 web based remote desktop gateway that makes it easy to access remote servers and desktops through a web browser. It supports standard protocols like VNC, RDP, and SSH.

Kubernetes is fast developing and this deployment will target `kubernetes 1.16.x`.

## Image Usage

Images are fetched from Docker's image repo:

Guacamole: 1.1.0

* https://hub.docker.com/u/guacamole - Base

* https://hub.docker.com/r/guacamole/guacamole - guacamole/guacamole:1.1.0
* https://hub.docker.com/r/guacamole/guacd - guacamole/guacd:1.1.0

MariaDB (MySQL Clone): 10.5.3

* https://hub.docker.com/_/mariadb/ - mariadb:10.5.3

InitContainer - Data Onramp : 1.1.0

* https://hub.docker.com/r/d2iqshadowbq/guacd-helper/tags d2iqshadowbq/guacd-helper:1.1.0

## Install on D2iQ Konvoy

https://d2iq.com/solutions/ksphere/konvoy#request-free-trial

Enable you cluster: `konvoy up -y`

### Install

`kubectl apply -f manifests`

Example: https://a39306ab925214a18bbedd2ded635581-1473587611.us-east-1.elb.amazonaws.com/guacamole/guacamole/#/

## Automatic Initializing the MySQL database

The initcontainer on `guacamole-app` automatically applies the standard schema, and default user `guacadmin`.

## Troubleshooting & Spiking SQL Data

You can deploy pod `manifest/90-guacd-helper-pod.yaml` which you can use to sql into the backend if needed.

```bash
$> kubectl cp guacamole.sql guacamole-helper:/home/d2iq --namespace guacamole
$> kubectl exec -it guacamole-helper --namespace guacamole -- /bin/bash
[d2iq@guacamole-helper /]$ cd ~
[d2iq@guacamole-helper ~]$ mysql -h $MYSQL_HOSTNAME -u $MYSQL_USER -p$MYSQL_PASSWORD $MYSQL_DATABASE < guacamole.sql
[d2iq@guacamole-helper ~]$ $$PROFIT$$
```