Skip to content

Commit bbcb17a

Browse files
committed
update the Bicep extensibility provider name to extension
1 parent 4c7f4fc commit bbcb17a

File tree

7 files changed

+39
-30
lines changed

7 files changed

+39
-30
lines changed

.openpublishing.redirection.azure-resource-manager.json

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,10 @@
11
{
22
"redirections": [
3+
{
4+
"source_path_from_root": "/articles/aks/learn/quick-kubernetes-deploy-bicep-extensibility-kubernetes-provider.md",
5+
"redirect_url": "/articles/aks/learn/quick-kubernetes-deploy-bicep-kubernetes-extension",
6+
"redirect_document_id": false
7+
},
38
{
49
"source_path_from_root": "/articles/app-service-web/app-service-move-resources.md",
510
"redirect_url": "/azure/azure-resource-manager/management/move-limitations/app-service-move-limitations",
@@ -1155,6 +1160,11 @@
11551160
"redirect_url": "/azure/azure-resource-manager/bicep/compare-template-syntax",
11561161
"redirect_document_id": false
11571162
},
1163+
{
1164+
"source_path_from_root": "/articles/azure-resource-manager/bicep/bicep-extensibility-kubernetes-provider.md",
1165+
"redirect_url": "/azure/azure-resource-manager/bicep/bicep-kubernetes-extensions",
1166+
"redirect_document_id": false
1167+
},
11581168
{
11591169
"source_path_from_root": "/articles/azure-resource-manager/templates/complete-mode-deletion.md",
11601170
"redirect_url": "/azure/azure-resource-manager/templates/deployment-complete-mode-deletion",

articles/aks/learn/quick-kubernetes-deploy-bicep-extensibility-kubernetes-provider.md renamed to articles/aks/learn/quick-kubernetes-deploy-bicep-kubernetes-extension.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
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).
44
author: tamram
55

66
ms.topic: quickstart
@@ -11,15 +11,15 @@ ms.author: tamram
1111
#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.
1212
---
1313

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)
1515

1616
Azure Kubernetes Service (AKS) is a managed Kubernetes service that lets you quickly deploy and manage clusters. In this quickstart, you:
1717

18-
- Deploy an AKS cluster using the Bicep extensibility Kubernetes provider (preview).
18+
- Deploy an AKS cluster using the Bicep Kubernetes extension (preview).
1919
- Run a sample multi-container application with a group of microservices and web front ends simulating a retail scenario.
2020

2121
> [!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:
2323
>
2424
> ```json
2525
> {
@@ -74,7 +74,7 @@ Save a copy of the file as `main.bicep` to your local computer.
7474
7575
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:
7676
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":::
7878
7979
- **Store front**: Web application for customers to view products and place orders.
8080
- **Product service**: Shows product information.
@@ -323,7 +323,7 @@ To deploy the application, you use a manifest file to create all the objects req
323323
1. Press <kbd>Ctrl+Shift+P</kbd> to open **Command Palette**.
324324
1. Search for **bicep**, and then select **Bicep: Import Kubernetes Manifest**.
325325
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":::
327327
328328
1. Select `aks-store-quickstart.yaml` from the prompt. This process creates an `aks-store-quickstart.bicep` file in the same folder.
329329
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
388388
1. Find the **store-front** service and copy the value for **External IP**.
389389
1. Open a web browser to the external IP address of your service to see the Azure Store app in action.
390390
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":::
392392
393393
## Delete the cluster
394394

articles/azure-resource-manager/bicep/bicep-import.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ ms.date: 06/03/2024
88

99
# Imports in Bicep
1010

11-
This article describes the syntax you use to export and import shared functionality, as well as namespaces for Bicep extensibility providers.
11+
This article describes the syntax you use to export and import shared functionality, as well as namespaces for Bicep extensions.
1212

1313
## Exporting types, variables and functions
1414

@@ -80,7 +80,7 @@ output greeting string = sayHello('Bicep user')
8080
output exampleObject myImports.myObjectType = exampleObject
8181
```
8282

83-
## Import namespaces and extensibility providers (Preview)
83+
## Import namespaces and extensions (Preview)
8484

8585
> [!NOTE]
8686
> The experimental feature `extensibility` must be enabled from the [Bicep config file](./bicep-config.md#enable-experimental-features) to use this feature.
@@ -94,25 +94,25 @@ import '[email protected]'
9494

9595
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).
9696

97-
The syntax for importing Bicep extensibility providers is:
97+
The syntax for importing Bicep extensions is:
9898

9999
```bicep
100-
import '<provider-name>@<provider-version>'
100+
import '<extension-name>@<extension-version>'
101101
```
102102

103-
The syntax for importing Bicep extensibility providers which require configuration is:
103+
The syntax for importing Bicep extensions which require configuration is:
104104

105105
```bicep
106-
import '<provider-name>@<provider-version>' with {
107-
<provider-properties>
106+
import '<extension-name>@<extension-version>' with {
107+
<extension-properties>
108108
}
109109
```
110110

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).
112112

113113
## Next steps
114114

115115
- To learn about the Bicep data types, see [Data types](./data-types.md).
116116
- 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).

articles/azure-resource-manager/bicep/bicep-extensibility-kubernetes-provider.md renamed to articles/azure-resource-manager/bicep/bicep-kubernetes-extension.md

Lines changed: 11 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,17 @@
11
---
2-
title: Bicep extensibility Kubernetes provider
3-
description: Learn how to Bicep Kubernetes provider to deploy .NET applications to Azure Kubernetes Service clusters.
2+
title: Bicep Kubernetes extension
3+
description: Learn how to Bicep Kubernetes extension to deploy .NET applications to Azure Kubernetes Service clusters.
44
ms.topic: conceptual
55
ms.custom: devx-track-bicep, devx-track-dotnet
6-
ms.date: 03/20/2024
6+
ms.date: 06/27/2024
77
---
88

9-
# Bicep extensibility Kubernetes provider (Preview)
9+
# Bicep Kubernetes extension (Preview)
1010

11-
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).
1212

1313
> [!NOTE]
14-
> Kubernetes provider is not currently supported for private clusters:
14+
> Kubernetes extension is not currently supported for private clusters:
1515
>
1616
> ```bicep
1717
> resource AKS 'Microsoft.ContainerService/managedClusters@2023-01-02-preview' = {
@@ -24,7 +24,6 @@ The Kubernetes provider allows you to create Kubernetes resources directly with
2424
> }
2525
>
2626
> ```
27-
>
2827
2928
## Enable the preview feature
3029
@@ -38,12 +37,12 @@ This preview feature can be enabled by configuring the [bicepconfig.json](./bice
3837
}
3938
```
4039
41-
## Import Kubernetes provider
40+
## Import Kubernetes extension
4241

4342
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.
4544

46-
The following sample imports the Kubernetes provider:
45+
The following sample imports the Kubernetes extension:
4746

4847
```bicep
4948
@secure()
@@ -55,7 +54,7 @@ import '[email protected]' with {
5554
} as k8s
5655
```
5756

58-
- **namespace**: Specify the namespace of the provider.
57+
- **namespace**: Specify the namespace of the extension.
5958
- **KubeConfig**: Specify a base64 encoded value of the [Kubernetes cluster admin credentials](/rest/api/aks/managed-clusters/list-cluster-admin-credentials).
6059

6160
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
8180

8281
## Next steps
8382

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

Comments
 (0)