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 user is on a Windows client, provides only Windows PowerShell command-line examples, and uses Windows file paths (e.g., C:\Users\user). There are no equivalent Linux/macOS instructions, shell commands, or file path examples. Windows-specific tools and commands (such as New-HcsKubernetesNamespace) are referenced without Linux alternatives, and the documentation repeatedly refers to using a Windows client as the primary scenario.
Recommendations:
- Provide parallel Linux/macOS instructions and examples for all steps, including shell command syntax and file paths (e.g., ~/user/.kube).
- Include Linux/macOS command-line output samples alongside PowerShell examples.
- Clarify which steps or tools are Windows-only and offer Linux/macOS alternatives where possible.
- Reference cross-platform tools and commands first, or at least equally, rather than prioritizing Windows-specific tools.
- Explicitly state any limitations or differences for non-Windows clients early in the prerequisites section.
- Where Windows PowerShell commands are used (e.g., New-HcsKubernetesNamespace), document if/how these can be run from Linux/macOS, or provide REST API/CLI alternatives.
Create pull request
Flagged Code Snippets
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 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 delete pvc mysql-pv-claim -n userns1
persistentvolumeclaim "mysql-pv-claim" deleted
C:\Users\user>
C:\Users\user>kubectl get pods -n "userns1"
No resources found in userns1 namespace.
C:\Users\user>
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: mysql-pv-claim
spec:
volumeName: <smb-share-name-here>
storageClassName: ""
accessModes:
- ReadWriteOnce
resources:
requests:
storage: 20Gi
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 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 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>