This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

Getting-Started

1 - Release Notes

Changelog KOSI 2.9.2

Fixed

  • Fixed an issue in push - command, which caused a missleading error message.
  • Fixed an issue in the housekeeping functionality, that prevent working properly.

Changelog KOSI 2.9.2_Beta0

Fixed

  • Fixed an issue where KOSI was still running successfully even if a image could not be pulled
  • Fixed an issue where images where only pushed once
  • Fixed an issue where update could be executed with an invalid deployment name
  • Fixed an issue where delete could be executed with an invalid deployment name

Changelog KOSI 2.9.1

Update

  • update nuget packages
  • update kosi plugin

Changelog KOSI 2.9.0

New

  • SINA renamed to KOSI
  • new code format for creating packages named package.kosi
  • added the possibility to use sha tag values.
  • added an image-clean-up if you use retagging in KOSI
  • added KOSI remove - command, for removing your own packages from the hub
  • added checking syntax of new package.kosi and lint for package.yaml

2 - About Kosi

What is KOSI?

KOSI is a specially designed software installer for Kubernates cluster. It helps you define, install, and manage self-contained packages for Kubernetes. These packages can be configured for different needs.

Why to use KOSI?

KOSI , with its usability inspired by helm, enables software developers to create packages. You can include many artifacts and the necessary dependencies in one single KOSI package. At the time of software deployment into your environments you only need to download this package from KubeOps hub. All relevant dependencies are managed by KOSI insuring installation.

This makes the process of installing software with KOSI into your cluster simplified, secure and flawless.

Highlights

  • KOSI is beneficial over other package managers due to its unique feature of assisting you to bundle images along other artifacts in the package.

  • KOSI due to its ability to produce single self-sufficient package eliminates the chances of human errors caused due to Manual Processing in software deployment.

  • KOSI provides you the pre-built plugins along which enable to execute few most common tasks through KOSI packages. You can also easily access other plugins through our KubeOps hub.

  • KOSI facilitates you to deliver your software through KOSI even in the complex environments where outgoing proxy preventing broad access to the internet.

  • KOSI is compatible with Helm and docker.

Click here to download and get started with KOSI now.

3 - Quickstart

How to install KOSI

This quickstart shows you how to install KOSI. KOSI can be downloaded only from our official website.

Install KOSI as user

Prerequisites

Before you begin, check the following prerequisites:

  1. A machine with any of the following operating systems
  • RHEL 8
  • openSUSE or SUSE Linux Enterprise Server Version 15 SP3
  1. You must have Helm installed on your machine.

Refer Helm Official Documentation for Installation Guide.

  1. For KOSI versions you must have installed Podman on your machine.

Note : Before installing podman, make sure that The number of user namespaces (max_user_namespaces) is specified on your system if you are a non root-user.
For more information, follow this Github link

To install podman on your OS use command:

dnf install podman
zypper install podman

Important: Only supports secure registries. If you use an insecure registry, it is important to list your registry as an insecure registry in registry.conf (/etc/containers/registries.conf).

Installation Steps

Every release of KOSI provides a rpm file for manual installation. You need to login into your KubeOps account to download the file.

  1. Create an KubOps account on the KubeOps website if you don’t have already and login into your account.

  2. Download your desired version of KOSI .rpm file from our official download page https://kubeops.net/products/downloads/kosi-downloads-en

  3. Install the KOSI rpm on master node or admin node (recommended). 

    dnf install <path to rpm>/<kosi file name>
    zypper install <path to rpm>/<kosi file name>

path to rpm : the directory path in which the file is available.
kosi file name : the exact file name of the file with .rpm extension.

Check Installation

You can check if the kosi is installed correctly on your machine simply with command kosi version.

kosi version

If the output indicates kosi version and relative information, KOSI is installed successfully.

For example the output should look like

KOSI version: 2.9.0_Alpha0_1701852856
This work is licensed under Creative Commons Attribution - NoDerivatives 4.0 International License(see https://creativecommons.org/licenses/by-nd/4.0/legalcode for more details).
©KubeOps GmbH, Hinter Stöck 17, 72406 Bisingen - Germany, 2022

Create a KOSI package

If you have installed KOSI on your machine, you can not only download and install packages, you can also create your own packages.

Create a KOSI package

Upgrade to newer KOSI version

If you have already installed KOSI on your machine and want to upgrade to a newer version, please install the new version with same steps mentioned above.

Once you have successfully installed KOSI, you are ready to use KOSI.
Update KOSI