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 exhibits a strong Windows bias. It assumes the user is on a Windows client, specifies Windows PowerShell as a prerequisite, and provides all command-line examples in a Windows context (including PowerShell prompts and Windows file paths). There are no Linux/macOS-specific instructions, examples, or file path conventions, and the use of Windows-specific tools and commands is emphasized throughout.
Recommendations:
- Provide parallel instructions and examples for Linux/macOS clients, including shell commands and file paths (e.g., ~/.kube instead of C:\Users\<username>\.kube).
- Mention and demonstrate how to install and use kubectl on Linux/macOS, not just Windows.
- Replace or supplement PowerShell-specific command prompts and output with Bash equivalents.
- Clarify that the procedure is cross-platform and explicitly state any differences or limitations for non-Windows users.
- Where Windows-specific tools (e.g., New-HcsKubernetesNamespace) are mentioned, note if there are Linux equivalents or if these steps must be performed from a Windows system.
- Ensure screenshots and file path references are not exclusively Windows-centric, or provide alternatives for other operating systems.
Create pull request
Flagged Code Snippets
C:\Users\user>kubectl get pods -n "userns1"
No resources found in userns1 namespace.
C:\Users\user>
C:\Users\user>kubectl describe pvc mysql-pv-claim -n userns1
Name: mysql-pv-claim
Namespace: userns1
StorageClass:
Status: Bound
Volume: mylocalsmbshare1
Labels: <none>
Annotations: kubectl.kubernetes.io/last-applied-configuration:
{"apiVersion":"v1","kind":"PersistentVolumeClaim","metadata":{"annotations":{},"name":"mysql-pv-claim","namespace":"userns1"},"spec":{"acc...
pv.kubernetes.io/bind-completed: yes
Finalizers: [kubernetes.io/pvc-protection]
Capacity: 32Ti
Access Modes: RWO,RWX
VolumeMode: Filesystem
Mounted By: mysql-c85f7f79c-vzz7j
Events: <none>
C:\Users\user>
C:\Users\user>kubectl apply -f "C:\stateful-application\mysql-pv.yml" -n userns1
persistentvolumeclaim/mysql-pv-claim 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>kubectl describe deployment mysql -n userns1
Name: mysql
Namespace: userns1
CreationTimestamp: Tue, 18 Aug 2020 09:44:58 -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
ReadOnly: false
Conditions:
Type Status Reason
---- ------ ------
Progressing True NewReplicaSetAvailable
Available True MinimumReplicasAvailable
OldReplicaSets: <none>
NewReplicaSet: mysql-c85f7f79c (1/1 replicas created)
Events:
Type Reason Age From Message
---- ------ ---- ---- -------
Normal ScalingReplicaSet 10m deployment-controller Scaled up replica set mysql-c85f7f79c to 1
C:\Users\user>
C:\Users\user>kubectl get pods -l app=mysql -n userns1
NAME READY STATUS RESTARTS AGE
mysql-c85f7f79c-vzz7j 1/1 Running 1 14m
C:\Users\user>
C:\Users\user>kubectl exec mysql-c85f7f79c-vzz7j -i -t -n userns1 -- mysql
Welcome to the MySQL monitor. Commands end with ; or \g.
Your MySQL connection id is 1
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 -n userns1
persistentvolumeclaim "mysql-pv-claim" deleted
C:\Users\user>