Giter Club home page Giter Club logo

juju-dashboard-charm's Introduction

Juju Dashboard Charm

This repository contains charms that deploy the dashboard for Juju and JAAS into Machine and Kubernetes environments.

Building and Testing the Machine Charm

Building the machine charm is fairly straightforward. You need a machine with Juju 3.0+ installed. The rest of the steps, in brief, are:

# From the root directory of this repo

# Build the charm
cd ./machine-charm
charmcraft pack

# Bootstrap a test controller. Make a make a model, and deploy an application, so that the dashboard has things to show.
juju bootstrap localhost localhost-test
juju add-model test
juju switch test
juju deploy ubuntu

# Switch to the controller model and setup the dashboard
juju switch controller
juju deploy ./juju-dashboard*.charm dashboard
juju relate controller dashboard
juju dashboard

Once you login following the instructions in the output of juju dashboard you should be able to see the controller model, as well as the test model and test application that you deployed.

Building and Testing the k8s charm

This guide covers every step necessary to build and test a k8s charm, from updating the facades in js-libjuju, to rebuilding the dashboard source, to building the charm. You can skip some steps if you don't need to update every part of the toolchain.

Install Juju 3.0

Bulid from source, or snap install --channel=3.0/beta juju

Install Docker Engine

Follow the guide on the docker website to install the latest version of the Docker engine.

Bootstrap microk8s

Follow the guide here

In brief:

snap install microk8s --classic

sudo usermod -a -G microk8s $USER
sudo chown -f -R $USER ~/.kube
su - $USER

microk8s status --wait-ready
microk8s.enable hostpath-storage dns

microk8s config | juju add-k8s --client micro
juju bootstrap micro

jaas-dashboard

Source

  1. Checkout [email protected]:canonical-web-and-design/jaas-dashboard.git
  2. Build the container with DOCKER_BUILDKIT=1 docker build -t juju-dashboard .
  3. Take note of the image id. You can get it with docker image inspect juju-dashboard | grep "Id"
  4. Add the docker image that you just build to microk8s' build in docker repo, as it cannot talk to the docker registry on the host machine: docker image save <image id> | microk8s ctr image import -

Building the Kubernetes Charm

You're finally ready to build the charm! Change to the root directory of this repo, and run:

# Build the charm
cd ./k8s-charm
charmcraft pack

# Switch to the controller model and deploy the dashboard
juju switch controller
# image id must include: "sha256:..."
juju deploy --resource dashboard-image=<image id> ./juju-dashboard*.charm dashboard
juju relate controller dashboard
juju dashboard

Login to the dashboard, per the instructions from the juju dashboard command.

Tips and Tricks for Testing

Acccess the Dashboard Without a Proxy

Sometimes, it may be useful to access the dashboard directly, rather than through the ssh tunnel. (E.g., you are trying to determine which part of the pipeline has broken, or access a test server remotely.)

This is made difficult in development environments, where the controller will typically be using self signed certs. Modern browsers will simply refuse to connect to the controller API. Here's a workaround:

In Firefox, Accept the Controller's Self Signed Cert

You must tell your browser to trust the controller's cert in order to get a working dashboard. This requires Firefox, or another browser that allows you to override the security warning. Here's how to do so:

  1. From the CLI, execute juju switch controller && juju status
  2. Note the ip address for the controller, and for the dashboard.
  3. Open Firefox, and visit https://:17070
  4. Click to the advanced part of the security prompt, and accept the risk.
  5. Firefox will display a "bad request" page. This is okay. You have successfully accepted the ssl cert!

Visit the dashboard

  1. From the CLI, execute juju dashboard, and make note of the username and password. You don't need to leave the command running, as you are accessing the dashboard directly, rather than using the proxy server.
  2. In Firefox, visit https://.
  3. Login with username and password you obtained in step 1.

juju-dashboard-charm's People

Contributors

alesstimec avatar barrettj12 avatar goulinkh avatar hatched avatar jpmartinspt avatar pengale avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.