You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/aks/learn/quick-kubernetes-deploy-bicep-kubernetes-extension.md
+8-8Lines changed: 8 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
---
2
-
title: Deploy an AKS cluster using the Bicep extensibility Kubernetes provider
3
-
description: Learn how to quickly deploy a Kubernetes cluster using the Bicep extensibility Kubernetes provider and deploy an application in Azure Kubernetes Service (AKS).
2
+
title: Deploy an AKS cluster using the Bicep Kubernetes extension
3
+
description: Learn how to quickly deploy a Kubernetes cluster using the Bicep Kubernetes extension and deploy an application in Azure Kubernetes Service (AKS).
4
4
author: tamram
5
5
6
6
ms.topic: quickstart
@@ -11,15 +11,15 @@ ms.author: tamram
11
11
#Customer intent: As a developer or cluster operator, I want to quickly deploy an AKS cluster and deploy an application so that I can see how to run applications using the managed Kubernetes service in Azure.
12
12
---
13
13
14
-
# Quickstart: Deploy an Azure Kubernetes Service (AKS) cluster using the Bicep extensibility Kubernetes provider (preview)
14
+
# Quickstart: Deploy an Azure Kubernetes Service (AKS) cluster using the Bicep Kubernetes extension (preview)
15
15
16
16
Azure Kubernetes Service (AKS) is a managed Kubernetes service that lets you quickly deploy and manage clusters. In this quickstart, you:
17
17
18
-
- Deploy an AKS cluster using the Bicep extensibility Kubernetes provider (preview).
18
+
- Deploy an AKS cluster using the Bicep Kubernetes extension (preview).
19
19
- Run a sample multi-container application with a group of microservices and web front ends simulating a retail scenario.
20
20
21
21
> [!IMPORTANT]
22
-
> The Bicep Kubernetes provider is currently in preview. You can enable the feature from the [Bicep configuration file](../../azure-resource-manager/bicep/bicep-config.md#enable-experimental-features) by adding:
22
+
> The Bicep Kubernetes extension is currently in preview. You can enable the feature from the [Bicep configuration file](../../azure-resource-manager/bicep/bicep-config.md#enable-experimental-features) by adding:
23
23
>
24
24
> ```json
25
25
> {
@@ -74,7 +74,7 @@ Save a copy of the file as `main.bicep` to your local computer.
74
74
75
75
To deploy the application, you use a manifest file to create all the objects required to run the [AKS Store application](https://github.com/Azure-Samples/aks-store-demo). A [Kubernetes manifest file][kubernetes-deployment] defines a cluster's desired state, such as which container images to run. The manifest includes the following Kubernetes deployments and services:
76
76
77
-
:::image type="content" source="media/quick-kubernetes-deploy-bicep-extensibility-kubernetes-provider/aks-store-architecture.png" alt-text="Screenshot of Azure Store sample architecture." lightbox="media/quick-kubernetes-deploy-bicep-extensibility-kubernetes-provider/aks-store-architecture.png":::
77
+
:::image type="content" source="media/quick-kubernetes-deploy-bicep-kubernetes-extension/aks-store-architecture.png" alt-text="Screenshot of Azure Store sample architecture." lightbox="media/quick-kubernetes-deploy-bicep-kubernetes-extension/aks-store-architecture.png":::
78
78
79
79
- **Store front**: Web application for customers to view products and place orders.
80
80
- **Product service**: Shows product information.
@@ -323,7 +323,7 @@ To deploy the application, you use a manifest file to create all the objects req
323
323
1. Press <kbd>Ctrl+Shift+P</kbd> to open **Command Palette**.
324
324
1. Search for **bicep**, and then select **Bicep: Import Kubernetes Manifest**.
325
325
326
-
:::image type="content" source="./media/quick-kubernetes-deploy-bicep-extensibility-kubernetes-provider/bicep-extensibility-kubernetes-provider-import-kubernetes-manifest.png" alt-text="Screenshot of Visual Studio Code import Kubernetes Manifest." lightbox="./media/quick-kubernetes-deploy-bicep-extensibility-kubernetes-provider/bicep-extensibility-kubernetes-provider-import-kubernetes-manifest.png":::
326
+
:::image type="content" source="./media/quick-kubernetes-deploy-bicep-kubernetes-extension/bicep-kubernetes-extension-import-kubernetes-manifest.png" alt-text="Screenshot of Visual Studio Code import Kubernetes Manifest." lightbox="./media/quick-kubernetes-deploy-bicep-kubernetes-extension/bicep-kubernetes-extension-import-kubernetes-manifest.png":::
327
327
328
328
1. Select `aks-store-quickstart.yaml` from the prompt. This process creates an `aks-store-quickstart.bicep` file in the same folder.
329
329
1. Open `main.bicep` and add the following Bicep at the end of the file to reference the newly created `aks-store-quickstart.bicep` module:
@@ -388,7 +388,7 @@ It takes a few minutes to create the AKS cluster. Wait for the cluster successfu
388
388
1. Find the **store-front** service and copy the value for **External IP**.
389
389
1. Open a web browser to the external IP address of your service to see the Azure Store app in action.
390
390
391
-
:::image type="content" source="media/quick-kubernetes-deploy-bicep-extensibility-kubernetes-provider/aks-store-application.png" alt-text="Screenshot of AKS Store sample application." lightbox="media/quick-kubernetes-deploy-bicep-extensibility-kubernetes-provider/aks-store-application.png":::
391
+
:::image type="content" source="media/quick-kubernetes-deploy-bicep-kubernetes-extension/aks-store-application.png" alt-text="Screenshot of AKS Store sample application." lightbox="media/quick-kubernetes-deploy-bicep-kubernetes-extension/aks-store-application.png":::
## Import namespaces and extensibility providers (Preview)
83
+
## Import namespaces and extensions (Preview)
84
84
85
85
> [!NOTE]
86
86
> The experimental feature `extensibility` must be enabled from the [Bicep config file](./bicep-config.md#enable-experimental-features) to use this feature.
Both `az` and `sys` are Bicep built-in namespaces. They are imported by default. For more information about the data types and the functions defined in `az` and `sys`, see [Data types](./data-types.md) and [Bicep functions](./bicep-functions.md).
96
96
97
-
The syntax for importing Bicep extensibility providers is:
97
+
The syntax for importing Bicep extensions is:
98
98
99
99
```bicep
100
-
import '<provider-name>@<provider-version>'
100
+
import '<extension-name>@<extension-version>'
101
101
```
102
102
103
-
The syntax for importing Bicep extensibility providers which require configuration is:
103
+
The syntax for importing Bicep extensions which require configuration is:
104
104
105
105
```bicep
106
-
import '<provider-name>@<provider-version>' with {
107
-
<provider-properties>
106
+
import '<extension-name>@<extension-version>' with {
107
+
<extension-properties>
108
108
}
109
109
```
110
110
111
-
For an example, see [Bicep extensibility Kubernetes provider](./bicep-extensibility-kubernetes-provider.md).
111
+
For an example, see [Bicep Kubernetes extension](./bicep-kubernetes-extension.md).
112
112
113
113
## Next steps
114
114
115
115
- To learn about the Bicep data types, see [Data types](./data-types.md).
116
116
- To learn about the Bicep functions, see [Bicep functions](./bicep-functions.md).
117
-
- To learn about how to use the Kubernetes provider, see [Bicep extensibility Kubernetes provider](./bicep-extensibility-kubernetes-provider.md).
118
-
- To go through a Kubernetes provider tutorial, see [Quickstart - Deploy Azure applications to Azure Kubernetes Services by using Bicep Kubernetes provider.](../../aks/learn/quick-kubernetes-deploy-bicep-extensibility-kubernetes-provider.md).
117
+
- To learn about how to use the Kubernetes extension, see [Bicep Kubernetes extension](./bicep-kubernetes-extension.md).
118
+
- To go through a Kubernetes extension tutorial, see [Quickstart - Deploy Azure applications to Azure Kubernetes Services by using Bicep Kubernetes extension.](../../aks/learn/quick-kubernetes-deploy-bicep-kubernetes-extension.md).
The Kubernetes provider allows you to create Kubernetes resources directly with Bicep. Bicep can deploy anything that can be deployed with the [Kubernetes command-line client (kubectl)](https://kubernetes.io/docs/reference/kubectl/kubectl/) and a [Kubernetes manifest file](../../aks/concepts-clusters-workloads.md#deployments-and-yaml-manifests).
11
+
The Kubernetes extension allows you to create Kubernetes resources directly with Bicep. Bicep can deploy anything that can be deployed with the [Kubernetes command-line client (kubectl)](https://kubernetes.io/docs/reference/kubectl/kubectl/) and a [Kubernetes manifest file](../../aks/concepts-clusters-workloads.md#deployments-and-yaml-manifests).
12
12
13
13
> [!NOTE]
14
-
> Kubernetes provider is not currently supported for private clusters:
14
+
> Kubernetes extension is not currently supported for private clusters:
15
15
>
16
16
> ```bicep
17
17
> resource AKS 'Microsoft.ContainerService/managedClusters@2023-01-02-preview' = {
@@ -24,7 +24,6 @@ The Kubernetes provider allows you to create Kubernetes resources directly with
24
24
> }
25
25
>
26
26
> ```
27
-
>
28
27
29
28
## Enable the preview feature
30
29
@@ -38,12 +37,12 @@ This preview feature can be enabled by configuring the [bicepconfig.json](./bice
38
37
}
39
38
```
40
39
41
-
## Import Kubernetes provider
40
+
## Import Kubernetes extension
42
41
43
42
To safely pass secrets for the Kubernetes deployment, you must invoke the Kubernetes code with a Bicep module and pass the parameter as a secret.
44
-
To import the Kubernetes provider, use the [import statement](./bicep-import-providers.md). After importing the provider, you can refactor the Bicep module file as usual, such as by using variables, parameters, and output. By contract, the Kubernetes manifest in YML doesn't include any programmability support.
43
+
To import the Kubernetes extension, use the [import statement](./bicep-import.md). After importing the extension, you can refactor the Bicep module file as usual, such as by using variables, parameters, and output. By contract, the Kubernetes manifest in YML doesn't include any programmability support.
45
44
46
-
The following sample imports the Kubernetes provider:
45
+
The following sample imports the Kubernetes extension:
-**namespace**: Specify the namespace of the provider.
57
+
-**namespace**: Specify the namespace of the extension.
59
58
-**KubeConfig**: Specify a base64 encoded value of the [Kubernetes cluster admin credentials](/rest/api/aks/managed-clusters/list-cluster-admin-credentials).
60
59
61
60
The following sample shows how to pass `kubeConfig` value from a parent Bicep file:
@@ -81,4 +80,4 @@ From Visual Studio Code, you can import Kubernetes manifest files to create Bice
81
80
82
81
## Next steps
83
82
84
-
-[Quickstart - Deploy Azure applications to Azure Kubernetes Services by using Bicep extensibility Kubernetes provider](../../aks/learn/quick-kubernetes-deploy-bicep-extensibility-kubernetes-provider.md)
83
+
-[Quickstart - Deploy Azure applications to Azure Kubernetes Services by using Bicep Kubernetes extension](../../aks/learn/quick-kubernetes-deploy-bicep-kubernetes-extension.md)
0 commit comments