Skip to content

Commit 0455d3d

Browse files
authored
Merge pull request #413 from cnvergence/integration-crossplane
add crossplane integration example
2 parents b8be801 + 857cc8d commit 0455d3d

12 files changed

Lines changed: 806 additions & 11 deletions

File tree

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,3 @@
11
nav:
2-
- cert-manager.md
2+
- cert-manager.md
3+
- crossplane.md

docs/content/usage/integrations/cert-manager.md

Lines changed: 28 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -9,8 +9,26 @@ weight: 10
99

1010
1. **Install cert-manager** in your Kubernetes cluster, where kube-bind backend is running, if you haven't already. You can follow the official installation guide [here](https://cert-manager.io/docs/installation/kubernetes/).
1111

12+
2. **Add kube-bind export label** to certificate CRD.
1213

13-
2. **Create a `kube-bind` template for `Certificate` resources** to allow service consumers to request TLS certificates. Below is an example template:
14+
```bash
15+
kubectl label crd certificates.cert-manager.io kube-bind.io/exported=true --overwrite
16+
```
17+
18+
3. **Create SelfSigned issuer** in the provider cluster.
19+
20+
```yaml
21+
kubectl apply -f - <<EOF
22+
apiVersion: cert-manager.io/v1
23+
kind: ClusterIssuer
24+
metadata:
25+
name: my-selfsigned-issuer
26+
spec:
27+
selfSigned: {}
28+
EOF
29+
```
30+
31+
4. **Create a `kube-bind` template for `Certificate` resources** to allow service consumers to request TLS certificates. Below is an example template:
1432

1533
```yaml
1634
kubectl apply -f - <<EOF
@@ -39,18 +57,18 @@ spec:
3957
EOF
4058
```
4159

42-
3. **Login into the kube-bind CLI** and request a binding to the `certificate` template created above. This will allow you to create `Certificate` resources in your consumer cluster.
60+
5. **Login into the kube-bind CLI** and request a binding to the `certificate` template created above. This will allow you to create `Certificate` resources in your consumer cluster.
4361

4462
```bash
4563
kubectl bind login https://kube-bind.example.com
4664
# you will get redirected to UI to authenticate and pick the template
47-
kubectl bind
65+
kubectl bind
4866
```
4967

50-
4. **Wait for the binding to be established.** Once the binding is active, you can create `Certificate` resources in your consumer cluster, and you will get `Certificate` objects synced from the provider cluster.
68+
6. **Wait for the binding to be established.** Once the binding is active, you can create `Certificate` resources in your consumer cluster, and you will get `Certificate` objects synced from the provider cluster.
5169

5270
```bash
53-
kubectl bind
71+
kubectl bind
5472
🌐 Opening kube-bind UI in your browser...
5573
https://kube-bind.genericcontrolplane.io?redirect_url=....
5674

@@ -69,11 +87,11 @@ Created 1 APIServiceBinding(s):
6987
Resources bound successfully!
7088
```
7189

72-
5. **Create a `Certificate` resource** in your consumer cluster. The cert-manager in the provider cluster will handle the issuance and management of the TLS certificate.
90+
7. **Create a `Certificate` resource** in your consumer cluster. The cert-manager in the provider cluster will handle the issuance and management of the TLS certificate.
7391

7492
!!! note
7593
my-selfsigned-issuer must be present in the provider cluster for this example to work.
76-
94+
7795
```yaml
7896
kubectl apply -f - <<EOF
7997
apiVersion: cert-manager.io/v1
@@ -91,13 +109,13 @@ spec:
91109
EOF
92110
```
93111

94-
6. Observe that the `Certificate` resource is created in the consumer cluster and the corresponding TLS secret is generated.
112+
8. Observe that the `Certificate` resource is created in the consumer cluster and the corresponding TLS secret is generated.
95113

96114
```bash
97-
kubectl get certificates
115+
kubectl get certificates
98116
NAME READY SECRET AGE
99117
my-tls-cert True my-tls-cert 6m55s
100118
kubectl get secrets
101119
NAME TYPE DATA AGE
102120
my-tls-cert kubernetes.io/tls 3 6m33s
103-
```
121+
```

0 commit comments

Comments
 (0)