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/concepts-clusters-workloads.md
+11-11Lines changed: 11 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,7 +14,7 @@ ms.author: mlearned
14
14
15
15
As application development moves towards a container-based approach, the need to orchestrate and manage resources is important. Kubernetes is the leading platform that provides the ability to provide reliable scheduling of fault-tolerant application workloads. Azure Kubernetes Service (AKS) is a managed Kubernetes offering that further simplifies container-based application deployment and management.
16
16
17
-
This article introduces the core Kubernetes infrastructure components such as the *cluster master*, *nodes*, and *node pools*. Workload resources such as *pods*, *deployments*, and *sets* are also introduced, along with how to group resources into *namespaces*.
17
+
This article introduces the core Kubernetes infrastructure components such as the *control plane*, *nodes*, and *node pools*. Workload resources such as *pods*, *deployments*, and *sets* are also introduced, along with how to group resources into *namespaces*.
18
18
19
19
## What is Kubernetes?
20
20
@@ -24,41 +24,41 @@ You can build and run modern, portable, microservices-based applications that be
24
24
25
25
As an open platform, Kubernetes allows you to build your applications with your preferred programming language, OS, libraries, or messaging bus. Existing continuous integration and continuous delivery (CI/CD) tools can integrate with Kubernetes to schedule and deploy releases.
26
26
27
-
Azure Kubernetes Service (AKS) provides a managed Kubernetes service that reduces the complexity for deployment and core management tasks, including coordinating upgrades. The AKS cluster masters are managed by the Azure platform, and you only pay for the AKS nodes that run your applications. AKS is built on top of the open-source Azure Kubernetes Service Engine ([aks-engine][aks-engine]).
27
+
Azure Kubernetes Service (AKS) provides a managed Kubernetes service that reduces the complexity for deployment and core management tasks, including coordinating upgrades. The AKS control plane is managed by the Azure platform, and you only pay for the AKS nodes that run your applications. AKS is built on top of the open-source Azure Kubernetes Service Engine ([aks-engine][aks-engine]).
28
28
29
29
## Kubernetes cluster architecture
30
30
31
31
A Kubernetes cluster is divided into two components:
32
32
33
-
-*Cluster master* nodes provide the core Kubernetes services and orchestration of application workloads.
33
+
-*Control plane* nodes provide the core Kubernetes services and orchestration of application workloads.
34
34
-*Nodes* run your application workloads.
35
35
36
-
36
+
37
37
38
-
## Cluster master
38
+
## Control plane
39
39
40
-
When you create an AKS cluster, a cluster master is automatically created and configured. This cluster master is provided as a managed Azure resource abstracted from the user. There's no cost for the cluster master, only the nodes that are part of the AKS cluster.
40
+
When you create an AKS cluster, a control plane is automatically created and configured. This control plane is provided as a managed Azure resource abstracted from the user. There's no cost for the control plane, only the nodes that are part of the AKS cluster.
41
41
42
-
The cluster master includes the following core Kubernetes components:
42
+
The control plane includes the following core Kubernetes components:
43
43
44
44
-*kube-apiserver* - The API server is how the underlying Kubernetes APIs are exposed. This component provides the interaction for management tools, such as `kubectl` or the Kubernetes dashboard.
45
45
-*etcd* - To maintain the state of your Kubernetes cluster and configuration, the highly available *etcd* is a key value store within Kubernetes.
46
46
-*kube-scheduler* - When you create or scale applications, the Scheduler determines what nodes can run the workload and starts them.
47
47
-*kube-controller-manager* - The Controller Manager oversees a number of smaller Controllers that perform actions such as replicating pods and handling node operations.
48
48
49
-
AKS provides a single-tenant cluster master, with a dedicated API server, Scheduler, etc. You define the number and size of the nodes, and the Azure platform configures the secure communication between the cluster master and nodes. Interaction with the cluster master occurs through Kubernetes APIs, such as `kubectl` or the Kubernetes dashboard.
49
+
AKS provides a single-tenant control plane, with a dedicated API server, Scheduler, etc. You define the number and size of the nodes, and the Azure platform configures the secure communication between the control plane and nodes. Interaction with the control plane occurs through Kubernetes APIs, such as `kubectl` or the Kubernetes dashboard.
50
50
51
-
This managed cluster master means that you don't need to configure components like a highly available *etcd* store, but it also means that you can't access the cluster master directly. Upgrades to Kubernetes are orchestrated through the Azure CLI or Azure portal, which upgrades the cluster master and then the nodes. To troubleshoot possible issues, you can review the cluster master logs through Azure Monitor logs.
51
+
This managed control plane means that you don't need to configure components like a highly available *etcd* store, but it also means that you can't access the control plane directly. Upgrades to Kubernetes are orchestrated through the Azure CLI or Azure portal, which upgrades the control plane and then the nodes. To troubleshoot possible issues, you can review the control plane logs through Azure Monitor logs.
52
52
53
-
If you need to configure the cluster master in a particular way or need direct access to them, you can deploy your own Kubernetes cluster using [aks-engine][aks-engine].
53
+
If you need to configure the control plane in a particular way or need direct access to it, you can deploy your own Kubernetes cluster using [aks-engine][aks-engine].
54
54
55
55
For associated best practices, see [Best practices for cluster security and upgrades in AKS][operator-best-practices-cluster-security].
56
56
57
57
## Nodes and node pools
58
58
59
59
To run your applications and supporting services, you need a Kubernetes *node*. An AKS cluster has one or more nodes, which is an Azure virtual machine (VM) that runs the Kubernetes node components and container runtime:
60
60
61
-
- The `kubelet` is the Kubernetes agent that processes the orchestration requests from the cluster master and scheduling of running the requested containers.
61
+
- The `kubelet` is the Kubernetes agent that processes the orchestration requests from the control plane and scheduling of running the requested containers.
62
62
- Virtual networking is handled by the *kube-proxy* on each node. The proxy routes network traffic and manages IP addressing for services and pods.
63
63
- The *container runtime* is the component that allows containerized applications to run and interact with additional resources such as the virtual network and storage. In AKS, Moby is used as the container runtime.
> *[Create an Azure Speech Resource](../../../../get-started.md)
22
23
> *[Create a LUIS application and get an endpoint key](../../../../quickstarts/create-luis.md)
23
24
> *[Setup your development environment](../../../../quickstarts/setup-platform.md?tabs=windows)
@@ -37,16 +38,16 @@ Let's add some code that works as a skeleton for our project. Make note that you
37
38
38
39
## Create a Speech configuration
39
40
40
-
Before you can initialize a`IntentRecognizer` object, you need to create a configuration that uses your LUIS Endpoing key and region. Insert this code in the `recognizeIntent()` method.
41
+
Before you can initialize an`IntentRecognizer` object, you need to create a configuration that uses your LUIS Endpoint key and region. Insert this code in the `recognizeIntent()` method.
41
42
42
43
This sample uses the `FromSubscription()` method to build the `SpeechConfig`. For a full list of available methods, see [SpeechConfig Class](https://docs.microsoft.com/cpp/cognitive-services/speech/speechconfig).
43
44
44
45
> [!NOTE]
45
-
> It is important to use the LUIS Endpoint key and not the Starter or Authroing keys as only the Endpoint key is valid for speech to intent recognition. See [Create a LUIS application and get an endpoint key](~/articles/cognitive-services/Speech-Service/quickstarts/create-luis.md) for instructions on how to get the correct key.
46
+
> It is important to use the LUIS Endpoint key and not the Starter or Authoring keys as only the Endpoint key is valid for speech to intent recognition. See [Create a LUIS application and get an endpoint key](~/articles/cognitive-services/Speech-Service/quickstarts/create-luis.md) for instructions on how to get the correct key.
@@ -58,8 +59,8 @@ You now need to associate a `LanguageUnderstandingModel` with the intent recogni
58
59
59
60
## Recognize an intent
60
61
61
-
From the `IntentRecognizer` object, you're going to call the `RecognizeOnceAsync()` method. This method lets the Speech service know that you're sending a single phrase for recognition, and that once the phrase is identified to stop reconizing speech.
62
-
For similicity we'll wait on the future returned to complete.
62
+
From the `IntentRecognizer` object, you're going to call the `RecognizeOnceAsync()` method. This method lets the Speech service know that you're sending a single phrase for recognition, and that once the phrase is identified to stop recognizing speech.
63
+
For simplicity we'll wait on the future returned to complete.
Now you're ready to build your app and test our speech recognition using the Speech service.
83
84
84
-
1.**Compile the code** - From the menu bar of Visual Stuio, choose **Build** > **Build Solution**.
85
+
1.**Compile the code** - From the menu bar of Visual Studio, choose **Build** > **Build Solution**.
85
86
2.**Start your app** - From the menu bar, choose **Debug** > **Start Debugging** or press **F5**.
86
87
3.**Start recognition** - It'll prompt you to speak a phrase in English. Your speech is sent to the Speech service, transcribed as text, and rendered in the console.
> *[Create an Azure Speech Resource](../../../../get-started.md)
22
23
> *[Create a LUIS application and get an endpoint key](../../../../quickstarts/create-luis.md)
23
24
> *[Setup your development environment](../../../../quickstarts/setup-platform.md?tabs=dotnet)
@@ -37,18 +38,18 @@ Let's add some code that works as a skeleton for our project. Make note that you
37
38
38
39
## Create a Speech configuration
39
40
40
-
Before you can initialize a`IntentRecognizer` object, you need to create a configuration that uses your LUIS Endpoing key and region. Insert this code in the `RecognizeIntentAsync()` method.
41
+
Before you can initialize an`IntentRecognizer` object, you need to create a configuration that uses your LUIS Endpoint key and region. Insert this code in the `RecognizeIntentAsync()` method.
41
42
42
43
This sample uses the `FromSubscription()` method to build the `SpeechConfig`. For a full list of available methods, see [SpeechConfig Class](https://docs.microsoft.com/dotnet/api/microsoft.cognitiveservices.speech.speechconfig?view=azure-dotnet).
43
44
44
45
> [!NOTE]
45
-
> It is important to use the LUIS Endpoint key and not the Starter or Authroing keys as only the Endpoint key is valid for speech to intent recognition. See [Create a LUIS application and get an endpoint key](~/articles/cognitive-services/Speech-Service/quickstarts/create-luis.md) for instructions on how to get the correct key.
46
+
> It is important to use the LUIS Endpoint key and not the Starter or Authoring keys as only the Endpoint key is valid for speech to intent recognition. See [Create a LUIS application and get an endpoint key](~/articles/cognitive-services/Speech-Service/quickstarts/create-luis.md) for instructions on how to get the correct key.
Now, let's create a`IntentRecognizer`. This object is created inside of a using statement to ensure the proper release of unmanaged resources. Insert this code in the `RecognizeIntentAsync()` method, right below your Speech configuration.
52
+
Now, let's create an`IntentRecognizer`. This object is created inside of a using statement to ensure the proper release of unmanaged resources. Insert this code in the `RecognizeIntentAsync()` method, right below your Speech configuration.
@@ -58,7 +59,7 @@ You now need to associate a `LanguageUnderstandingModel` with the intent recogni
58
59
59
60
## Recognize an intent
60
61
61
-
From the `IntentRecognizer` object, you're going to call the `RecognizeOnceAsync()` method. This method lets the Speech service know that you're sending a single phrase for recognition, and that once the phrase is identified to stop reconizing speech.
62
+
From the `IntentRecognizer` object, you're going to call the `RecognizeOnceAsync()` method. This method lets the Speech service know that you're sending a single phrase for recognition, and that once the phrase is identified to stop recognizing speech.
In this quickstart you will use the [Speech SDK](~/articles/cognitive-services/speech-service/speech-sdk.md) to interactively recognize speech from audio data captured from a microphone. After satisfying a few prerequisites, recognizing speech from a microphone only takes four steps:
17
17
> [!div class="checklist"]
18
+
>
18
19
> * Create a ````SpeechConfig```` object from your subscription key and region.
19
-
> * Create a````IntentRecognizer```` object using the ````SpeechConfig```` object from above.
20
+
> * Create an````IntentRecognizer```` object using the ````SpeechConfig```` object from above.
20
21
> * Using the ````IntentRecognizer```` object, start the recognition process for a single utterance.
21
-
> * Inspect the ````IntentRecognitionResult```` returned.
22
+
> * Inspect the ````IntentRecognitionResult```` returned.
> *[Create an Azure Speech Resource](../../../../get-started.md)
22
23
> *[Create a LUIS application and get an endpoint key](../../../../quickstarts/create-luis.md)
23
24
> *[Setup your development environment](../../../../quickstarts/setup-platform.md?tabs=jre)
@@ -34,18 +35,18 @@ Let's add some code that works as a skeleton for our project.
34
35
35
36
## Create a Speech configuration
36
37
37
-
Before you can initialize a`IntentRecognizer` object, you need to create a configuration that uses your LUIS Endpoing key and region. Insert this code in the try / catch block in main
38
+
Before you can initialize an`IntentRecognizer` object, you need to create a configuration that uses your LUIS Endpoint key and region. Insert this code in the try / catch block in main
38
39
39
40
This sample uses the `FromSubscription()` method to build the `SpeechConfig`. For a full list of available methods, see [SpeechConfig Class](https://docs.microsoft.com/dotnet/api/microsoft.cognitiveservices.speech.speechconfig?view=azure-dotnet).
40
41
41
42
> [!NOTE]
42
-
> It is important to use the LUIS Endpoint key and not the Starter or Authroing keys as only the Endpoint key is valid for speech to intent recognition. See [Create a LUIS application and get an endpoint key](~/articles/cognitive-services/Speech-Service/quickstarts/create-luis.md) for instructions on how to get the correct key.
43
+
> It is important to use the LUIS Endpoint key and not the Starter or Authoring keys as only the Endpoint key is valid for speech to intent recognition. See [Create a LUIS application and get an endpoint key](~/articles/cognitive-services/Speech-Service/quickstarts/create-luis.md) for instructions on how to get the correct key.
@@ -55,7 +56,7 @@ You now need to associate a `LanguageUnderstandingModel` with the intent recogni
55
56
56
57
## Recognize an intent
57
58
58
-
From the `IntentRecognizer` object, you're going to call the `recognizeOnceAsync()` method. This method lets the Speech service know that you're sending a single phrase for recognition, and that once the phrase is identified to stop reconizing speech.
59
+
From the `IntentRecognizer` object, you're going to call the `recognizeOnceAsync()` method. This method lets the Speech service know that you're sending a single phrase for recognition, and that once the phrase is identified to stop recognizing speech.
0 commit comments