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

https://github.com/kadras-io/package-for-secretgen-controller

Kubernetes-native package for secretgen-controller, a cloud-native solution to generate and share Secrets, passwords, keys, and certificates.
https://github.com/kadras-io/package-for-secretgen-controller

kadras kapp-controller kubernetes platform-engineering secrets-management

Last synced: 12 days ago
JSON representation

Kubernetes-native package for secretgen-controller, a cloud-native solution to generate and share Secrets, passwords, keys, and certificates.

Awesome Lists containing this project

README

          

# secretgen-controller

![Test Workflow](https://github.com/kadras-io/package-for-secretgen-controller/actions/workflows/test.yml/badge.svg)
![Release Workflow](https://github.com/kadras-io/package-for-secretgen-controller/actions/workflows/release.yml/badge.svg)
[![The SLSA Level 3 badge](https://slsa.dev/images/gh-badge-level3.svg)](https://slsa.dev/spec/v1.0/levels)
[![The Apache 2.0 license badge](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
[![Follow us on Bluesky](https://img.shields.io/static/v1?label=Bluesky&message=Follow&color=1DA1F2)](https://bsky.app/profile/kadras.bsky.social)

A Carvel package for [secretgen-controller](https://github.com/carvel-dev/secretgen-controller), a cloud-native solution to generate and share Secrets, passwords, keys, and certificates.

## 🚀  Getting Started

### Prerequisites

* Kubernetes 1.33+
* Carvel [`kctrl`](https://carvel.dev/kapp-controller/docs/latest/install/#installing-kapp-controller-cli-kctrl) CLI.
* Carvel [kapp-controller](https://carvel.dev/kapp-controller) deployed in your Kubernetes cluster. You can install it with Carvel [`kapp`](https://carvel.dev/kapp/docs/latest/install) (recommended choice) or `kubectl`.

```shell
kapp deploy -a kapp-controller -y \
-f https://github.com/carvel-dev/kapp-controller/releases/latest/download/release.yml
```

### Installation

Add the Kadras [package repository](https://github.com/kadras-io/kadras-packages) to your Kubernetes cluster:

```shell
kctrl package repository add -r kadras-packages \
--url ghcr.io/kadras-io/kadras-packages \
-n kadras-system --create-namespace
```

Installation without package repository
The recommended way of installing the secretgen-controller package is via the Kadras package repository. If you prefer not using the repository, you can add the package definition directly using kapp or kubectl.

```shell
kubectl create namespace kadras-system
kapp deploy -a secretgen-controller-package -n kadras-system -y \
-f https://github.com/kadras-io/package-for-secretgen-controller/releases/latest/download/metadata.yml \
-f https://github.com/kadras-io/package-for-secretgen-controller/releases/latest/download/package.yml
```

Install the secretgen-controller package:

```shell
kctrl package install -i secretgen-controller \
-p secretgen-controller.packages.kadras.io \
-v ${VERSION} \
-n kadras-system
```

> **Note**
> You can find the `${VERSION}` value by retrieving the list of package versions available in the Kadras package repository installed on your cluster.
>
> ```shell
> kctrl package available list -p secretgen-controller.packages.kadras.io -n kadras-system
> ```

Verify the installed packages and their status:

```shell
kctrl package installed list -n kadras-system
```

## 📙  Documentation

Documentation, tutorials and examples for this package are available in the [docs](docs) folder.
For documentation specific to secretgen-controller, check out [github.com/carvel-dev/secretgen-controller](https://github.com/carvel-dev/secretgen-controller).

## 🛡️  Security

The security process for reporting vulnerabilities is described in [SECURITY.md](SECURITY.md).

## 🖊️  License

This project is licensed under the **Apache License 2.0**. See [LICENSE](LICENSE) for more information.