529d5f7652
All Airship projects are moving to GitHub issues. This change adds a GitHub security policy that links to the official Airship vulnerability management process [0]. When users on GitHub click "New Issue" on this GitHub repository, they will see an option to report a security vulnerability, which will direct them to our official policy. [0] https://airship-docs.readthedocs.io/en/latest/security/vulnerabilities.html Change-Id: Iaf060dd0085c21f0c4f18f100e3e053b5ceedbed Signed-off-by: Drew Walters <andrew.walters@att.com>
Octant Airship UI Plugin
Airship UI is a wrapper around Octant together with Octant plugin(s) that allows you to view your kubernetes cluster. The airshipui command uses airshipctl's configuration in order to find and connect to the kubernetes cluster, launches the Octant server process, and directs your browser to the user interface.
Several plugins will be delivered with airshipui. The first, argoui, is a plugin that embeds the Argo UI interface within octant, and it requires that argo be installed on your kubernetes cluster (this should be the case by default with Airship 2.0, which uses argo as its workflow engine)
Prerequisites
- A working kubernetes or airship installation
- Go 1.12+
- Octant
- Argo
Getting Started
git clone https://opendev.org/airship/airshipui
cd airshipui
make build install-plugins
make install-plugins builds and installs the plugin to
$HOME/.config/octant/plugin/.
The next time Octant is run it will include plugins in the above directory. Further information for running Octant can be found in the Octant Repo.
If you would like to just build the plugin use make.
Architecture
airshipui is an executable that wraps Octant. When it is launched, it processes its own set of command-line options, performs any necessary custom startup tasks such as reading the airshipctl config file, then normally calls the function to instantiate Octant. This repository also contains airship plugins that will be generated as standard octant plugins, which are separate binaries.
Developer's Guide
Step by step sample installation and more details can be found in the Developer's Guide.