About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Bias Types:
⚠️
windows_first
⚠️
powershell_heavy
⚠️
missing_linux_example
⚠️
windows_tools
Summary:
The documentation page demonstrates a strong Windows bias. It assumes the client is a Windows system, specifies Windows PowerShell as a requirement, and all command-line examples are shown in PowerShell with Windows-style paths. There are no Linux/macOS shell examples, and instructions for saving files, running commands, and file paths are all Windows-centric. Linux tools, shell syntax, and file system conventions are not mentioned or demonstrated.
Recommendations:
- Provide parallel Linux/macOS instructions and examples alongside Windows ones, including bash shell commands and Unix-style file paths.
- Clarify in the prerequisites that Linux/macOS clients are fully supported and link to any relevant setup guides.
- Show sample outputs from Linux/macOS terminals as well as Windows PowerShell.
- Mention and demonstrate how to install and configure kubectl on Linux/macOS clients.
- Avoid assuming the use of Windows-specific tools (e.g., PowerShell, C:\ paths) in generic Kubernetes command examples.
- Where Windows-specific commands (e.g., New-HcsKubernetesNamespace) are required, note if there are Linux equivalents or clarify if these are only available on Windows.
Create pull request
Flagged Code Snippets
C:\Users\user>kubectl apply -f "C:\stateful-application\mysql-pvc.yml" -n userns1
persistentvolumeclaim/mysql-pv-claim-sc created
C:\Users\user>
C:\Users\user>kubectl apply -f "C:\stateful-application\mysql-deployment.yml" -n userns1
service/mysql created
deployment.apps/mysql created
C:\Users\user>
C:\Users\user>kubectl describe deployment mysql -n userns1
Name: mysql
Namespace: userns1
CreationTimestamp: Thu, 20 Aug 2020 11:14:25 -0700
Labels: <none>
Annotations: deployment.kubernetes.io/revision: 1
kubectl.kubernetes.io/last-applied-configuration:
{"apiVersion":"apps/v1","kind":"Deployment","metadata":{"annotations":{},"name":"mysql","namespace":"userns1"},"spec":{"selector":{"matchL...
Selector: app=mysql
Replicas: 1 desired | 1 updated | 1 total | 1 available | 0 unavailable
StrategyType: Recreate
MinReadySeconds: 0
Pod Template:
Labels: app=mysql
Containers:
mysql:
Image: mysql:5.6
Port: 3306/TCP
Host Port: 0/TCP
Environment:
MYSQL_ROOT_PASSWORD: password
Mounts:
/var/lib/mysql from mysql-persistent-storage (rw)
Volumes:
mysql-persistent-storage:
Type: PersistentVolumeClaim (a reference to a PersistentVolumeClaim in the same namespace)
ClaimName: mysql-pv-claim-sc
ReadOnly: false
Conditions:
Type Status Reason
---- ------ ------
Available True MinimumReplicasAvailable
Progressing True NewReplicaSetAvailable
OldReplicaSets: <none>
NewReplicaSet: mysql-695c4d9dcd (1/1 replicas created)
Events:
Type Reason Age From Message
---- ------ ---- ---- -------
Normal ScalingReplicaSet 24s deployment-controller Scaled up replica set mysql-695c4d9dcd to 1
C:\Users\user>
C:\Users\user>kubectl get pods -l app=mysql -n userns1
NAME READY STATUS RESTARTS AGE
mysql-695c4d9dcd-rvzff 1/1 Running 0 40s
C:\Users\user>
C:\Users\user>kubectl describe pvc mysql-pv-claim-sc -n userns1
Name: mysql-pv-claim-sc
Namespace: userns1
StorageClass: ase-node-local
Status: Bound
Volume: pvc-dc48253c-82dc-42a4-a7c6-aaddc97c9b8a
Labels: <none>
Annotations: kubectl.kubernetes.io/last-applied-configuration:
{"apiVersion":"v1","kind":"PersistentVolumeClaim","metadata":{"annotations":{},"name":"mysql-pv-claim-sc","namespace":"userns1"},"spec":{"...
pv.kubernetes.io/bind-completed: yes
pv.kubernetes.io/bound-by-controller: yes
volume.beta.kubernetes.io/storage-provisioner: rancher.io/local-path
volume.kubernetes.io/selected-node: k8s-3q7lhq2cl-3q7lhq2
Finalizers: [kubernetes.io/pvc-protection]
Capacity: 20Gi
Access Modes: RWO
VolumeMode: Filesystem
Mounted By: mysql-695c4d9dcd-rvzff
Events:
Type Reason Age From Message
---- ------ ---- ---- -------
Normal WaitForFirstConsumer 71s (x2 over 77s) persistentvolume-controller waiting for first consumer to be created before binding
Normal ExternalProvisioning 62s persistentvolume-controller waiting for a volume to be created, either by external provisioner "rancher.io/local-path" or manually created by system administrator
Normal Provisioning 62s rancher.io/local-path_local-path-provisioner-6b84988bf9-tx8mz_1896d824-f862-4cbf-912a-c8cc0ca05574 External provisioner is provisioning volume for claim "userns1/mysql-pv-claim-sc"
Normal ProvisioningSucceeded 60s rancher.io/local-path_local-path-provisioner-6b84988bf9-tx8mz_1896d824-f862-4cbf-912a-c8cc0ca05574 Successfully provisioned volume pvc-dc48253c-82dc-42a4-a7c6-aaddc97c9b8a
C:\Users\user>
C:\Users\user>kubectl exec mysql-695c4d9dcd-rvzff -i -t -n userns1 -- mysql -p
Enter password:
Welcome to the MySQL monitor. Commands end with ; or \g.
Your MySQL connection id is 3
Server version: 5.6.49 MySQL Community Server (GPL)
Copyright (c) 2000, 2020, Oracle and/or its affiliates. All rights reserved.
Oracle is a registered trademark of Oracle Corporation and/or its
affiliates. Other names may be trademarks of their respective
owners.
Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
mysql>
C:\Users\user>kubectl delete deployment,svc mysql -n userns1
deployment.apps "mysql" deleted
service "mysql" deleted
C:\Users\user>
C:\Users\user>kubectl delete pvc mysql-pv-claim-sc -n userns1
persistentvolumeclaim "mysql-pv-claim-sc" deleted
C:\Users\user>
C:\Users\user>kubectl get pods -n "userns1"
No resources found in userns1 namespace.
C:\Users\user>