From f1810c5006f34c9650ef7d68ba25d2480d6acbaa Mon Sep 17 00:00:00 2001 From: "R. Sharp" <8883519+tr0njavolta@users.noreply.github.com> Date: Sun, 4 Feb 2024 18:09:03 -0500 Subject: [PATCH 1/4] Update README.md --- README.md | 41 +++++++++++++++++++++++++++++++++++++++-- 1 file changed, 39 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index b3b2300..e0ae472 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,39 @@ -# configuration-azure-aks -Azure AKS Configuration +# [] Configuration + + +This repository contains a [Crossplane configuration](https://docs.crossplane.io/v1.11/concepts/packages/#configuration-packages), tailored for users establishing their initial control plane with [Upbound](https://cloud.upbound.io). This configuration deploys fully managed []() instances. + +## Overview + +The core components of a custom API in [Crossplane](https://docs.crossplane.io/v1.11/getting-started/introduction/) include: + +- **CompositeResourceDefinition (XRD):** Defines the API's structure. +- **Composition(s):** Implements the API by orchestrating a set of Crossplane managed resources. + +In this specific configuration, the [EKS] API contains: + +- **an [](/apis/definition.yaml) custom resource type.** +- **Composition of the [] resources:** Configured in [/apis/composition.yaml](/apis/composition.yaml), it provisions an [] and resources in the `upbound-system` namespace. + +This repository contains an Composite Resource (XR) file. + +## Deployment + +```shell +apiVersion: pkg.crossplane.io/v1 +kind: Configuration +metadata: + name: PACKAGE NAME +spec: + package: PACKAGE SPEC +``` + +## Next steps + +This repository serves as a foundational step. To enhance your control plane, consider: + +1. create new API definitions in this same repo +2. editing the existing API definition to your needs + + +Upbound will automatically detect the commits you make in your repo and build the configuration package for you. To learn more about how to build APIs for your managed control planes in Upbound, read the guide on Upbound's docs. From dadd42e22da6d38ec1b139690db2338dc2c0442b Mon Sep 17 00:00:00 2001 From: "R. Sharp" <8883519+tr0njavolta@users.noreply.github.com> Date: Mon, 5 Feb 2024 11:08:00 -0500 Subject: [PATCH 2/4] Update README.md --- README.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index e0ae472..a22f6a3 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,7 @@ -# [] Configuration +# Azure AKS Configuration -This repository contains a [Crossplane configuration](https://docs.crossplane.io/v1.11/concepts/packages/#configuration-packages), tailored for users establishing their initial control plane with [Upbound](https://cloud.upbound.io). This configuration deploys fully managed []() instances. +This repository contains a [Crossplane configuration](https://docs.crossplane.io/v1.11/concepts/packages/#configuration-packages), tailored for users establishing their initial control plane with [Upbound](https://cloud.upbound.io). This configuration deploys fully managed [Azure AKS](https://azure.microsoft.com/en-us/products/kubernetes-service) instances. ## Overview @@ -10,10 +10,10 @@ The core components of a custom API in [Crossplane](https://docs.crossplane.io/v - **CompositeResourceDefinition (XRD):** Defines the API's structure. - **Composition(s):** Implements the API by orchestrating a set of Crossplane managed resources. -In this specific configuration, the [EKS] API contains: +In this specific configuration, the AKS API contains: -- **an [](/apis/definition.yaml) custom resource type.** -- **Composition of the [] resources:** Configured in [/apis/composition.yaml](/apis/composition.yaml), it provisions an [] and resources in the `upbound-system` namespace. +- **an [AKS](/apis/definition.yaml) custom resource type.** +- **Composition of the AKS resources:** Configured in [/apis/composition.yaml](/apis/composition.yaml), it provisions an [] and resources in the `upbound-system` namespace. This repository contains an Composite Resource (XR) file. @@ -23,9 +23,9 @@ This repository contains an Composite Resource (XR) file. apiVersion: pkg.crossplane.io/v1 kind: Configuration metadata: - name: PACKAGE NAME + name: configuration-azure-aks spec: - package: PACKAGE SPEC + package: xpkg.upbound.io/upbound/configuration-azure-aks:v0.3.0 ``` ## Next steps From 79e6344baa8534aa429f549676152d613a4737f6 Mon Sep 17 00:00:00 2001 From: "R. Sharp" <8883519+tr0njavolta@users.noreply.github.com> Date: Wed, 7 Feb 2024 08:11:38 -1000 Subject: [PATCH 3/4] Update README.md --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index a22f6a3..84dd241 100644 --- a/README.md +++ b/README.md @@ -1,11 +1,11 @@ # Azure AKS Configuration -This repository contains a [Crossplane configuration](https://docs.crossplane.io/v1.11/concepts/packages/#configuration-packages), tailored for users establishing their initial control plane with [Upbound](https://cloud.upbound.io). This configuration deploys fully managed [Azure AKS](https://azure.microsoft.com/en-us/products/kubernetes-service) instances. +This repository contains a [Crossplane configuration](https://docs.crossplane.io/latest/concepts/packages/#configuration-packages), tailored for users establishing their initial control plane with [Upbound](https://cloud.upbound.io). This configuration deploys fully managed [Azure AKS](https://azure.microsoft.com/en-us/products/kubernetes-service) instances. ## Overview -The core components of a custom API in [Crossplane](https://docs.crossplane.io/v1.11/getting-started/introduction/) include: +The core components of a custom API in [Crossplane](https://docs.crossplane.io/latest/getting-started/introduction/) include: - **CompositeResourceDefinition (XRD):** Defines the API's structure. - **Composition(s):** Implements the API by orchestrating a set of Crossplane managed resources. From a7c798d390b151a7092c0313872166450b435928 Mon Sep 17 00:00:00 2001 From: Christopher Haar Date: Fri, 16 Feb 2024 07:19:51 +0100 Subject: [PATCH 4/4] docs(marketplace): adopt docs for marketplace Signed-off-by: Christopher Haar --- README.md | 2 +- crossplane.yaml | 5 +++++ 2 files changed, 6 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 84dd241..967bd59 100644 --- a/README.md +++ b/README.md @@ -13,7 +13,7 @@ The core components of a custom API in [Crossplane](https://docs.crossplane.io/l In this specific configuration, the AKS API contains: - **an [AKS](/apis/definition.yaml) custom resource type.** -- **Composition of the AKS resources:** Configured in [/apis/composition.yaml](/apis/composition.yaml), it provisions an [] and resources in the `upbound-system` namespace. +- **Composition of the AKS resources:** Configured in [/apis/composition.yaml](/apis/composition.yaml), it provisions an AKS cluster and resources and fundamental security and networking resources in the `upbound-system` namespace. This repository contains an Composite Resource (XR) file. diff --git a/crossplane.yaml b/crossplane.yaml index b34f306..492db83 100644 --- a/crossplane.yaml +++ b/crossplane.yaml @@ -6,6 +6,11 @@ metadata: meta.crossplane.io/maintainer: Upbound meta.crossplane.io/source: github.com/upbound/configuration-azure-aks meta.crossplane.io/license: Apache-2.0 + meta.crossplane.io/description: | + Azure AKS Configuration is reusable Configuration designed to be primarily used in higher level Configurations. + meta.crossplane.io/readme: | + This configuration bundles an Upbound Cloud extension and an API definition. This API allows control planes to provision Azure AKS clusters, composed using cloud service primitives from the Upbound Official Providers + spec: crossplane: version: ">=v1.14.1-0"