Skip to content

Commit d369ad5

Browse files
committed
docs: README
1 parent 95a9614 commit d369ad5

File tree

3 files changed

+48
-24
lines changed

3 files changed

+48
-24
lines changed

.github/workflows/e2e.yml

Lines changed: 14 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,21 @@ name: e2e-kind
22

33
on:
44
push:
5-
branches: [main]
5+
branches: [ main ]
6+
paths-ignore:
7+
- 'README.md'
8+
- 'LICENSE'
9+
- 'docs/**'
10+
- '.gitignore'
11+
- '.github/ISSUE_TEMPLATE/**'
612
pull_request:
7-
branches: [main]
13+
branches: [ main ]
14+
paths-ignore:
15+
- 'README.md'
16+
- 'LICENSE'
17+
- 'docs/**'
18+
- '.gitignore'
19+
- '.github/ISSUE_TEMPLATE/**'
820

921
jobs:
1022
kind-e2e:

.github/workflows/lint.yml

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,20 @@ name: lint
33
on:
44
push:
55
branches: [ main ]
6+
paths-ignore:
7+
- 'README.md'
8+
- 'LICENSE'
9+
- 'docs/**'
10+
- '.gitignore'
11+
- '.github/ISSUE_TEMPLATE/**'
612
pull_request:
713
branches: [ main ]
14+
paths-ignore:
15+
- 'README.md'
16+
- 'LICENSE'
17+
- 'docs/**'
18+
- '.gitignore'
19+
- '.github/ISSUE_TEMPLATE/**'
820

921
jobs:
1022
shell-lint:

README.md

Lines changed: 22 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -2,33 +2,33 @@
22

33
[![lint](https://github.com/hutstep/crossplane-kind-azure-bootstrap/actions/workflows/lint.yml/badge.svg)](https://github.com/hutstep/crossplane-kind-azure-bootstrap/actions/workflows/lint.yml) [![e2e-kind](https://github.com/hutstep/crossplane-kind-azure-bootstrap/actions/workflows/e2e.yml/badge.svg)](https://github.com/hutstep/crossplane-kind-azure-bootstrap/actions/workflows/e2e.yml) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
44

5-
Bootstrap a local [kind](https://kind.sigs.k8s.io/) cluster with [Crossplane](https://crossplane.io/), the Crossplane provider family for Azure, and selected Composition Functions. Designed to be robust, idempotent, and non-interactive friendly for both local use and CI.
5+
🚀 Bootstrap a local [kind](https://kind.sigs.k8s.io/) cluster with [Crossplane](https://crossplane.io/), the Crossplane provider family for Azure, and selected Composition Functions. Designed to be robust, idempotent, and non-interactive friendly for both local use and CI.
66

7-
## Features
7+
## Features
88

9-
- Creates or reuses a kind cluster (or targets current kubectl context)
10-
- Installs Crossplane via Helm chart (chart version controllable)
11-
- Installs provider family for Azure (provider-family-azure)
12-
- Installs Crossplane Composition Functions:
9+
- 🧰 Creates or reuses a kind cluster (or targets current kubectl context)
10+
- 📦 Installs Crossplane via Helm chart (chart version controllable)
11+
- ☁️ Installs provider family for Azure (provider-family-azure)
12+
- 🧩 Installs Crossplane Composition Functions:
1313
- function-patch-and-transform
1414
- function-environment-configs
15-
- Reliable health waits with JSONPath fallback
16-
- Cleanup modes (keep cluster, delete cluster, and force-clean leftovers)
17-
- Makefile with common targets
15+
- Reliable health waits with JSONPath fallback
16+
- 🧹 Cleanup modes (keep cluster, delete cluster, and force-clean leftovers)
17+
- 🧰 Makefile with common targets
1818

19-
## Prerequisites
19+
## Prerequisites
2020

21-
- Docker (required by kind)
22-
- kind ≥ 0.20.0
23-
- kubectl ≥ 1.25
24-
- Helm ≥ 3.11
21+
- 🐳 Docker (required by kind)
22+
- 🧱 kind ≥ 0.20.0
23+
- kubectl ≥ 1.25
24+
- Helm ≥ 3.11
2525
- Network access to:
2626
- https://charts.crossplane.io/stable/index.yaml
2727
- https://xpkg.crossplane.io/
2828

2929
Tip: Ensure all scripts in scripts/ are executable so you can run them directly (chmod +x scripts/\*).
3030

31-
## Quick start
31+
## 🚦 Quick start
3232

3333
- Non-interactive default install (creates kind cluster if missing):
3434
```bash
@@ -48,7 +48,7 @@ Tip: Ensure all scripts in scripts/ are executable so you can run them directly
4848
--func-envcfg-version v0.4.0
4949
```
5050

51-
## Makefile targets
51+
## 🧰 Makefile targets
5252

5353
- Bootstrap (idempotent):
5454
```bash
@@ -83,7 +83,7 @@ Tip: Ensure all scripts in scripts/ are executable so you can run them directly
8383
make clean-delete-cluster
8484
```
8585

86-
## Script flags (most-used)
86+
## ⚙️ Script flags (most-used)
8787

8888
- --yes Non-interactive assume-yes
8989
- --cluster-name NAME Kind cluster name (default: crossplane-kind)
@@ -101,7 +101,7 @@ Tip: Ensure all scripts in scripts/ are executable so you can run them directly
101101
- --dry-run Print planned actions only
102102
- --verbose Shell tracing (set -x)
103103

104-
## What gets installed
104+
## 📦 What gets installed
105105

106106
- Crossplane Helm chart from charts.crossplane.io (chart version you choose)
107107
- Provider family Azure package:
@@ -110,7 +110,7 @@ Tip: Ensure all scripts in scripts/ are executable so you can run them directly
110110
- xpkg.crossplane.io/crossplane-contrib/function-patch-and-transform:v0.9.0
111111
- xpkg.crossplane.io/crossplane-contrib/function-environment-configs:v0.4.0
112112

113-
## Verify installation
113+
## 🔍 Verify installation
114114

115115
```bash
116116
helm list -n crossplane-system
@@ -119,7 +119,7 @@ kubectl get functions.pkg.crossplane.io -o wide
119119
kubectl get pods -A
120120
```
121121

122-
## Cleanup
122+
## 🧹 Cleanup
123123

124124
- Keep cluster, remove providers/functions and Crossplane Helm release:
125125
```bash
@@ -134,13 +134,13 @@ kubectl get pods -A
134134
scripts/bootstrap-crossplane-kind.sh --cleanup --delete-cluster --yes
135135
```
136136

137-
## CI notes
137+
## 🧪 CI notes
138138

139139
- Ensure Docker-in-Docker or Docker is available on the runner (kind requires Docker).
140140
- Cache Helm repository data to speed up runs:
141141
- $HOME/.cache/helm
142142
- optionally $HOME/.config/helm/repositories.yaml
143143

144-
## License
144+
## 📜 License
145145

146146
This project is licensed under the MIT License - see [LICENSE](LICENSE) for details.

0 commit comments

Comments
 (0)