Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cloudnative-pg/cnpg-playground
Local Learning Environment for CloudNativePG Using Docker and Kind
https://github.com/cloudnative-pg/cnpg-playground
Last synced: about 1 month ago
JSON representation
Local Learning Environment for CloudNativePG Using Docker and Kind
- Host: GitHub
- URL: https://github.com/cloudnative-pg/cnpg-playground
- Owner: cloudnative-pg
- License: apache-2.0
- Created: 2024-09-18T09:51:26.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2024-10-21T15:05:56.000Z (3 months ago)
- Last Synced: 2024-10-21T20:18:03.399Z (3 months ago)
- Language: Shell
- Size: 112 KB
- Stars: 15
- Watchers: 2
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: CODEOWNERS
- Governance: GOVERNANCE.md
Awesome Lists containing this project
README
[](https://cloudnative-pg.io/)
# Local Learning Environment for CloudNativePG
Welcome to **`cnpg-playground`**, a local learning environment designed for
learning and experimenting with CloudNativePG using Docker and Kind.
## Prerequisites
Ensure you have the latest available versions of the following tools installed
on a Unix-based system:
- [Docker](https://www.docker.com/)
- [Git](https://git-scm.com/)
- [Kubectl](https://kubernetes.io/docs/tasks/tools/)
- [The `cnpg` plugin for `kubectl`](https://cloudnative-pg.io/documentation/current/kubectl-plugin/)
- [Kind](https://kind.sigs.k8s.io/)
You don’t need superuser privileges to run the scripts, but elevated
permissions may be required to install the prerequisites.
### Additional Tools
For an improved experience with the CNPG Playground, it’s recommended to
install the following tools:
- **[`curl`](https://curl.se/)**: Command-line tool for data transfer.
- **[`jq`](https://jqlang.github.io/jq/)**: JSON processor for handling API
outputs.
- **[`stern`](https://github.com/stern/stern)**: Multi-pod log tailing tool.
- **[`kubectx`](https://github.com/ahmetb/kubectx)**: Kubernetes context
switcher.
Recommended `kubectl` plugins:
- **[`view-secret`](https://github.com/elsesiy/kubectl-view-secret)**: Decodes
Kubernetes secrets.
- **[`view-cert`](https://github.com/lmolas/kubectl-view-cert)**: Inspects TLS
certificates.
These tools streamline working with the CNPG Playground.
## Local Environment Overview
This environment emulates a two-region infrastructure (EU and US), with each
region containing:
- An object storage service powered by [MinIO](https://min.io/) containers
- A Kubernetes cluster, deployed using [Kind](https://kind.sigs.k8s.io/),
consisting of:
- One control plane node
- One node for infrastructure components
- One node for applications
- Three nodes dedicated to PostgreSQL
The architecture is illustrated in the diagram below:
## Setting Up the Learning Environment
To set up the environment, simply run the following script:
```bash
./scripts/setup.sh
```
## Connecting to the Kubernetes Clusters
To configure and interact with both Kubernetes clusters during the learning
process, you will need to connect to them.
The **setup** script provides detailed instructions for accessing the clusters.
If you need to view the connection details again after the setup, you can
retrieve them by running:
```bash
./scripts/info.sh
```
## Inspecting Nodes in a Kubernetes Cluster
To inspect the nodes in a Kubernetes cluster, you can use the following
command:
```bash
kubectl get nodes
```
For example, when connected to the `k8s-eu` cluster, this command will display
output similar to:
```console
NAME STATUS ROLES AGE VERSION
k8s-eu-control-plane Ready control-plane 10m v1.31.0
k8s-eu-worker Ready infra 9m58s v1.31.0
k8s-eu-worker2 Ready app 9m58s v1.31.0
k8s-eu-worker3 Ready postgres 9m58s v1.31.0
k8s-eu-worker4 Ready postgres 9m58s v1.31.0
k8s-eu-worker5 Ready postgres 9m58s v1.31.0
```
In this example:
- The control plane node (`k8s-eu-control-plane`) manages the cluster.
- Worker nodes have different roles, such as `infra` for infrastructure, `app`
for application workloads, and `postgres` for PostgreSQL databases. Each node
runs Kubernetes version `v1.31.0`.
## Installing CloudNativePG on the Control Plane
To install the latest stable version of the CloudNativePG operator on the
control plane node in both Kubernetes clusters, run the following commands:
```bash
kubectl cnpg install generate --control-plane | \
kubectl --context kind-k8s-eu apply -f - --server-side
kubectl cnpg install generate --control-plane | \
kubectl --context kind-k8s-us apply -f - --server-side
```
These commands will deploy the CloudNativePG operator with server-side apply on
both the `kind-k8s-eu` and `kind-k8s-us` clusters.
Ensure that you have the latest version of the `cnpg` plugin installed on your
local machine.
## Cleaning up the Learning Environment
When you're ready to clean up and remove all resources from the learning
environment, run the following script to tear down the containers and
associated resources:
```bash
./scripts/teardown.sh
```
This will safely destroy all running containers and return your environment to
its initial state.
## Nix Flakes
Do you use Nix flakes? If you do, this package have a configured
dev shell that can be used with:
```
nix develop .
```
## Using Linux or WSL2
You may need:
```
sudo sysctl fs.inotify.max_user_watches=524288
sudo sysctl fs.inotify.max_user_instances=512
```
More information in the [relative ticket comment](https://github.com/kubernetes-sigs/kind/issues/3423#issuecomment-1872074526).