This is the multi-page printable view of this section. Click here to print.
कुबेरनेट्स प्रलेखन के इस खंड के पृष्ठ एकल कार्य करने का तरीका दिखाते हैं। आमतौर पर, कार्य पृष्ठ दिखाता है कि किसी एक काम को कई छोटे चरणों में विभाजित करके कैसे करना है।
यदि आप एक कार्य पृष्ठ लिखना चाहते हैं, तो देखें प्रलेखन के लिए एक पुल अनुरोध (Pull Request) बनाएं.
कुबेरनेट्स कमांड-लाइन टूल, kubectl, आपको कुबेरनेट्स क्लस्टर पर कमांड चलाने की अनुमति देता है।
आप एप्लिकेशन को डिप्लॉय करने, क्लस्टर संसाधनों का निरीक्षण और प्रबंधन करने और लॉग देखने के लिए kubectl का उपयोग कर सकते हैं।
kubectl संचालन की पूरी सूची सहित अधिक जानकारी के लिए, देखें
kubectl संदर्भ प्रलेखन.
kubectl विभिन्न प्रकार के Linux प्लेटफॉर्म, macOS और Windows पर इंस्टॉल करने योग्य है। नीचे अपना उपयुक्त ऑपरेटिंग सिस्टम खोजें।
kind आपको अपने कंप्यूटर पर कुबेरनेट्स चलाने देता है।
इस उपकरण के लिए आवश्यक है कि आपके पास
Docker इंस्टॉल और कॉन्फ़िगर किया गया हो।
kind क्विक स्टार्ट पृष्ठ आपको दिखाता है कि kind चलाने के लिए आपको क्या करने की आवश्यकता है।
kind की तरह, minikube एक उपकरण
है जो आपको स्थानीय स्तर पर कुबेरनेट्स चलाने देता है। minikube आपके कंप्यूटर
(windows, macOS और linux पीसी सहित) पर सिंगल-नोड कुबेरनेट्स क्लस्टर चलाता
है ताकि आप कुबेरनेट्स सीख सकें या डेवलपमेंट कर सकें।
यदि आपका ध्यान उपकरण को इंस्टॉल करने पर है तो आप मुख्य आरंभ करें! गाइड का अनुसरण कर सकते हैं।
minikube क्विक स्टार्ट गाइड देखें
एक बार जब आपके पास minikube काम कर रहा हो, तो आप इसका उपयोग नमूना एप्लिकेशन चलाने के लिए कर सकते हैं।
कुबेरनेट्स क्लस्टर बनाने और प्रबंधित करने के लिए आप kubeadm टूल का उपयोग कर सकते हैं। यह उपयोगकर्ता के अनुकूल तरीके से न्यूनतम व्यवहार्य, सुरक्षित क्लस्टर बनाने और चलाने के लिए आवश्यक कार्य करता है।
kubeadm इंस्टॉल करना आपको दिखाता है कि kubeadm को कैसे इंस्टॉल किया जाए। एक बार इंस्टॉल होने के बाद, आप इसका उपयोग क्लस्टर बनाने के लिए कर सकते हैं।
आप kubectl संस्करण का उपयोग करे जो आपके क्लस्टर के एक माइनर संस्करण के भीतर हो। उदाहरण के लिए, v1.33 क्लाइंट v1.32, v1.33 और v1.34 कण्ट्रोल प्लेन के साथ संवाद कर सकते हैं। kubectl के नवीनतम संस्करण का उपयोग करने से अप्रत्याशित मुद्दों से बचने में मदद मिलती है।
Linux पर kubectl संस्थापित करने के लिए निम्नलिखित विधियाँ मौजूद हैं:
कमांड से नवीनतम रिलीज डाउनलोड करें:
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl"
एक विशिष्ट संस्करण डाउनलोड करने के लिए, कमांड के $(curl -L -s https://dl.k8s.io/release/stable.txt) हिस्से को विशिष्ट संस्करण से बदलें।
उदाहरण के लिए, लिनक्स पर 1.33.0 संस्करण डाउनलोड करने के लिए, टाइप करें:
curl -LO https://dl.k8s.io/release/v1.33.0/bin/linux/amd64/kubectl
बाइनरी को मान्य करें (वैकल्पिक)
kubectl चेकसम फाइल डाउनलोड करें:
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl.sha256"
चेकसम फ़ाइल से kubectl बाइनरी को मान्य करें:
echo "$(<kubectl.sha256) kubectl" | sha256sum --check
यदि मान्य है, तो आउटपुट है:
kubectl: OK
अगर चेक फेल हो जाता है, तो sha256 nonzero स्थिति के साथ बाहर निकलता है और इस आउटपुट के समान प्रिंट करता है:
kubectl: FAILED
sha256sum: WARNING: 1 computed checksum did NOT match
kubectl इंस्टॉल करें
sudo install -o root -g root -m 0755 kubectl /usr/local/bin/kubectl
यदि आपके पास टारगेट सिस्टम पर रुट एक्सेस नहीं है, आप तब भी kubectl को ~/.local/bin डायरेक्टरी में इंस्टॉल कर सकते हैं:
chmod +x kubectl
mkdir -p ~/.local/bin/kubectl
mv ./kubectl ~/.local/bin/kubectl
# and then add ~/.local/bin/kubectl to $PATH
यह सुनिश्चित करने के लिए परीक्षण करें कि आपके द्वारा इंस्टॉल किया गया संस्करण उप-टू-डेट है:
kubectl version --client
apt पैकेज इंडेक्स को अपडेट करे और कुबेरनेट्स apt रिपॉजिटरी का उपयोग करने के लिए आवश्यक पैकेज इंस्टॉल करें:
sudo apt-get update
sudo apt-get install -y apt-transport-https ca-certificates curl gnupg
गूगल क्लाउड पब्लिक साइनिंग कुंजी (key) डाउनलोड करें:
sudo curl -fsSLo /usr/share/keyrings/kubernetes-archive-keyring.gpg https://packages.cloud.google.com/apt/doc/apt-key.gpg
कुबेरनेट्स apt रिपॉजिटरी को जोड़े:
echo "deb [signed-by=/usr/share/keyrings/kubernetes-archive-keyring.gpg] https://apt.kubernetes.io/ kubernetes-xenial main" | sudo tee /etc/apt/sources.list.d/kubernetes.list
नए रिपॉजिटरी के साथ apt पैकेज इंडेक्स अपडेट करें और kubectl इंस्टॉल करें:
sudo apt-get update
sudo apt-get install -y kubectl
cat <<EOF > /etc/yum.repos.d/kubernetes.repo
[kubernetes]
name=Kubernetes
baseurl=https://packages.cloud.google.com/yum/repos/kubernetes-el7-x86_64
enabled=1
gpgcheck=1
repo_gpgcheck=1
gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOF
yum install -y kubectl
यदि आप Ubuntu या किसी अन्य Linux डिस्ट्रीब्यूशन पर हैं जो snap पैकेज मैनेजर को सपोर्ट करता है, तो kubectl snap एप्लिकेशन के रूप में उपलब्ध है।
snap install kubectl --classic
kubectl version --client
यदि आप Linux पर Homebrew पैकेज मैनेजर का उपयोग कर रहे हैं, तो kubectl इंस्टालेशन के लिए उपलब्ध है।
brew install kubectl
kubectl version --client
kubectl को कुबेरनेट्स क्लस्टर को खोजने और एक्सेस करने के लिए, उसे
क्यूबकॉन्फिग फाइल(kubeconfig) की आवश्यकता होती है,
जो स्वचालित रूप से तब बनता है जब आप
kube-up.sh का उपयोग करके क्लस्टर बनाते हैं
या मिनीक्यूब क्लस्टर को सफलतापूर्वक डिप्लॉय करते हैं।
डिफ़ॉल्ट रूप से, kubectl कॉन्फ़िगरेशन ~/.kube/config पर स्थित होता है।
जाँच करें कि क्लस्टर स्टेट प्राप्त करके kubectl को ठीक से कॉन्फ़िगर किया गया है:
kubectl cluster-info
यदि आपको एक URL प्रतिक्रिया दिखती हैं, तो kubectl आपके क्लस्टर तक पहुँचने के लिए सही ढंग से कॉन्फ़िगर हुआ है।
यदि आपको निम्नलिखित संदेश दिखाई देता है, तो kubectl ठीक से कॉन्फ़िगर नहीं हुआ है या कुबेरनेट्स क्लस्टर से कनेक्ट करने में सक्षम नहीं है।
The connection to the server <server-name:port> was refused - did you specify the right host or port?
उदाहरण के लिए, यदि आप अपने लैपटॉप (स्थानीय रूप से) पर कुबेरनेट्स क्लस्टर चलाना चाहते हैं, तो आपको पहले मिनीक्यूब (minikube) जैसे टूल को इंस्टॉल करना होगा और ऊपर बताए गए कमांड को फिर से चलाना होगा।
यदि kubectl cluster-info URL प्रतिक्रिया देता है, लेकिन आप अपने क्लस्टर को एक्सेस नहीं कर पा रहें हैं, तो यह जाँचने के लिए कि क्या यह ठीक से कॉन्फ़िगर किया गया है, इस कमांड का उपयोग करें:
kubectl cluster-info dump
kubectl Bash और Zsh के लिए ऑटोकम्प्लेशन का सपोर्ट प्रदान करता है, जो आपका काफी समय बचा सकता है।
नीचे Bash और Zsh के लिए ऑटोकम्प्लेशन स्थापित करने की प्रक्रियाएँ हैं।
Bash के लिए kubectl समापन स्क्रिप्ट kubectl completion bash कमांड के साथ उत्पन्न की जा सकती है। आपके शेल में समापन स्क्रिप्ट को सोर्स करने से kubectl ऑटोकम्पलीशन सक्षम हो जाती है।
हालाँकि, समापन की स्क्रिप्ट bash-completion पर निर्भर हैं जिसका अर्थ है कि आपको पहले इस सॉफ़्टवेयर को इंस्टॉल करना होगा (आप type _init_completion चलाकर परीक्षण कर सकते हैं कि आपने पहले से bash-completion इंस्टॉल की है या नहीं)।
कई पैकेज मैनेजर द्वारा bash-completion प्रदान की जाती है (यहाँ देखें)। आप इसे apt-get install bash-completion या yum install bash-completion आदि के साथ इंस्टॉल कर सकते हैं।
यह कमांड /usr/share/bash-completion/bash_completion उत्त्पन्न करता है, जो bash-completion की मुख्य स्क्रिप्ट है। आपके पैकेज मैनेजर के आधार पर, आपको इस फाइल को अपनी ~/.bashrc फाइल में मैन्युअल रूप से सोर्स करना होगा।
यह पता लगाने के लिए, अपना शेल पुनः लोड करें और type _init_completion रन करे। यदि कमांड सफल होता है, तो आप पहले से ही तैयार हैं, अन्यथा अपनी ~/.bashrc फ़ाइल में निम्नलिखित जोड़ें:
source /usr/share/bash-completion/bash_completion
अपना शेल पुनः लोड करें और type _init_completion टाइप करके सत्यापित करें कि बैश-कम्पलीशन सही ढंग से इंस्टॉल है।
अब आपको यह सुनिश्चित करने की आवश्यकता है कि kubectl समापन स्क्रिप्ट आपके सभी शेल सत्रों (sourced) में प्राप्त हो जाए। आप ऐसा दो तरीकों से कर सकते हैं:
अपनी ~/.bashrc फ़ाइल में समापन स्क्रिप्ट सॉर्स करें:
echo 'source <(kubectl completion bash)' >>~/.bashr
समापन स्क्रिप्ट को /etc/bash_completion.d डायरेक्टरी में जोड़ें:
bash kubectl completion bash >/etc/bash_completion.d/kubectl
यदि आप के पास kubectl के लिए एक अन्य नाम (alias) है, तो आप उस अन्य नाम के साथ काम करने के लिए शेल समापन को बढ़ा सकते हैं:
echo 'alias k=kubectl' >>~/.bashrc
echo 'complete -F __start_kubectl k' >>~/.bashrc
/etc/bash_completion.d में सोर्स करता है।दोनों दृष्टिकोण बराबर हैं। आपके शेल को पुनः लोड करने के बाद, Kubectl ऑटोकम्पलीशन कार्य करना शुरू कर देगा।
Zsh के लिए kubectl कम्पलीशन स्क्रिप्ट kubectl completion zsh कमांड के साथ उत्पन्न की जा सकती है। आपके शेल में कम्पलीशन स्क्रिप्ट को सोर्स करने से kubectl ऑटो-कम्पलीशन सक्षम हो जाती है।
अपने सभी शेल सत्रों में ऐसा करने के लिए, निम्नलिखित को अपनी ~/.zshrc फ़ाइल में जोड़ें:
source <(kubectl completion zsh)
यदि आपके पास kubectl के लिए एक उपनाम है, तो आप उस उपनाम के साथ काम करने के लिए शेल कम्पलीशन को बढ़ा सकते हैं:
echo 'alias k=kubectl' >>~/.zshrc
echo 'complete -F __start_kubectl k' >>~/.zshrc
अपने शेल को पुनः लोड करने के बाद, kubectl ऑटो-कम्पलीशन कार्य करना चाहिए।
यदि आपको कोई त्रुटि मिलती है जैसे complete:13: command not found: compdef, तो अपनी ~/.zshrc फ़ाइल की शुरुआत में निम्नलिखित जोड़ें:
autoload -Uz compinit
compinit
kubectl convert प्लगइन इंस्टॉल करेंकुबेरनेट्स कमांड-लाइन टूल kubectl के लिए एक प्लगइन, जो आपको विभिन्न API संस्करण के बीच मैनिफ़ेस्ट को बदलने करने की अनुमति देता है।
यह विशेष रूप से नए कुबेरनेट्स रिलीज के साथ एक गैर-बहिष्कृत API संस्करण में मैनिफेस्ट को माइग्रेट करने में सहायक हो सकता है।
अधिक जानकारी के लिए, गैर पदावनत एपिस में विस्थापित करें पर जाएं।
कमांड से नवीनतम रिलीज डाउनलोड करें:
curl -LO https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl-convert
बाइनरी को मान्य करें (वैकल्पिक)
kubectl-convert चेकसम फ़ाइल डाउनलोड करें:
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl-convert.sha256"
चेकसम फ़ाइल से kubectl-convert बाइनरी को मान्य करें:
echo "$(<kubectl-convert.sha256) kubectl-convert" | sha256sum --check
यदि मान्य है, तो आउटपुट है:
kubectl-convert: OK
अगर चेक फेल हो जाता है, तो sha256 nonzero स्थिति के साथ बाहर निकलता है और इस आउटपुट के समान प्रिंट करता है:
kubectl-convert: FAILED
sha256sum: WARNING: 1 computed checksum did NOT match
kubectl-convert इंस्टॉल करें
sudo install -o root -g root -m 0755 kubectl-convert /usr/local/bin/kubectl-convert
सत्यापित करें कि प्लगइन सफलतापूर्वक इंस्टॉल है
kubectl convert --help
यदि आपको कोई त्रुटि नहीं दिखाई देती है, तो इसका मतलब है कि प्लगइन सफलतापूर्वक इंस्टॉल हो गया है।
आप kubectl संस्करण का उपयोग करे जो आपके क्लस्टर के एक माइनर संस्करण भीतर हो। उदाहरण के लिए, v1.33 क्लाइंट v1.32, v1.33 और v1.34 कण्ट्रोल प्लेन के साथ कम्युनिकेट कर सकते हैं। kubectl के नए संस्करण का उपयोग करने से समस्या से बचत हो सकती है।
macOS पर kubectl संस्थापित करने के लिए निम्नलिखित विधियाँ मौजूद हैं:
नवीनतम रिलीज़ डाउनलोड करें:
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/amd64/kubectl"
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/arm64/kubectl"
एक विशिष्ट संस्करण डाउनलोड करने के लिए, कमांड के इस हिस्से $(curl -L -s https://dl.k8s.io/release/stable.txt) को विशिष्ट संस्करण से बदलें।
उदाहरण के लिए, Intel macOS पर 1.33.0 संस्करण डाउनलोड करने के लिए, टाइप करें:
curl -LO "https://dl.k8s.io/release/v1.33.0/bin/darwin/amd64/kubectl"
और Apple Silicon macOS के लिए, टाइप करें:
curl -LO "https://dl.k8s.io/release/v1.33.0/bin/darwin/arm64/kubectl"
बाइनरी को मान्य करें (वैकल्पिक))
kubectl चेकसम फाइल डाउनलोड करें:
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/amd64/kubectl.sha256"
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/arm64/kubectl.sha256"
चेकसम फ़ाइल से kubectl बाइनरी को मान्य करें:
echo "$(<kubectl.sha256) kubectl" | shasum -a 256 --check
यदि मान्य है, तो आउटपुट है:
kubectl: OK
अगर चेक फेल हो जाता है, तो shasum nonzero स्थिति के साथ बाहर निकलता है और इस आउटपुट के समान प्रिंट करता है:
kubectl: FAILED
shasum: WARNING: 1 computed checksum did NOT match
kubectl बाइनरी को एक्सेक्यूट करने योग्य बनायें।
chmod +x ./kubectl
kubectl बाइनरी को अपने सिस्टम PATH के फ़ाइल स्थान पर ले जाएँ।
sudo mv ./kubectl /usr/local/bin/kubectl
sudo chown root: /usr/local/bin/kubectl
/usr/local/bin आपके पाथ एनवायरनमेंट वेरिएबल में है।यह सुनिश्चित करने के लिए परीक्षण करें कि आपके द्वारा इंस्टॉल किया गया संस्करण उप-टू-डेट है:
kubectl version --client
यदि आप macOS पर हैं और Homebrew पैकेज मैनेजर का उपयोग कर रहे हैं, आप Homebrew के साथ kubectl इंस्टॉल कर सकते हैं।
इंस्टालेशन कमांड रन करें:
brew install kubectl
या
brew install kubernetes-cli
यह सुनिश्चित करने के लिए परीक्षण करें कि आपके द्वारा इंस्टॉल किया गया संस्करण उप-टू-डेट है:
kubectl version --client
यदि आप macOS पर हैं और Macports पैकेज मैनेजर का उपयोग कर रहे हैं, आप Macports के साथ kubectl इंस्टॉल कर सकते हैं।
इंस्टालेशन कमांड रन करें:
sudo port selfupdate
sudo port install kubectl
यह सुनिश्चित करने के लिए परीक्षण करें कि आपके द्वारा इंस्टॉल किया गया संस्करण उप-टू-डेट है:
kubectl version --client
kubectl को कुबेरनेट्स क्लस्टर को खोजने और एक्सेस करने के लिए, उसे
क्यूबकॉन्फिग फाइल(kubeconfig) की आवश्यकता होती है,
जो स्वचालित रूप से तब बनता है जब आप
kube-up.sh का उपयोग करके क्लस्टर बनाते हैं
या मिनीक्यूब क्लस्टर को सफलतापूर्वक डिप्लॉय करते हैं।
डिफ़ॉल्ट रूप से, kubectl कॉन्फ़िगरेशन ~/.kube/config पर स्थित होता है।
जाँच करें कि क्लस्टर स्टेट प्राप्त करके kubectl को ठीक से कॉन्फ़िगर किया गया है:
kubectl cluster-info
यदि आपको एक URL प्रतिक्रिया दिखती हैं, तो kubectl आपके क्लस्टर तक पहुँचने के लिए सही ढंग से कॉन्फ़िगर हुआ है।
यदि आपको निम्नलिखित संदेश दिखाई देता है, तो kubectl ठीक से कॉन्फ़िगर नहीं हुआ है या कुबेरनेट्स क्लस्टर से कनेक्ट करने में सक्षम नहीं है।
The connection to the server <server-name:port> was refused - did you specify the right host or port?
उदाहरण के लिए, यदि आप अपने लैपटॉप (स्थानीय रूप से) पर कुबेरनेट्स क्लस्टर चलाना चाहते हैं, तो आपको पहले मिनीक्यूब (minikube) जैसे टूल को इंस्टॉल करना होगा और ऊपर बताए गए कमांड को फिर से चलाना होगा।
यदि kubectl cluster-info URL प्रतिक्रिया देता है, लेकिन आप अपने क्लस्टर को एक्सेस नहीं कर पा रहें हैं, तो यह जाँचने के लिए कि क्या यह ठीक से कॉन्फ़िगर किया गया है, इस कमांड का उपयोग करें:
kubectl cluster-info dump
kubectl Bash और Zsh के लिए ऑटोकम्प्लेशन का सपोर्ट प्रदान करता है, जो आपका काफी समय बचा सकता है।
नीचे Bash और Zsh के लिए ऑटोकम्प्लेशन स्थापित करने की प्रक्रियाएँ हैं।
Bash के लिए kubectl समापन स्क्रिप्ट kubectl completion bash कमांड के साथ उत्पन्न की जा सकती है। आपके शेल में समापन स्क्रिप्ट को सोर्स करने से kubectl ऑटोकम्पलीशन सक्षम हो जाती है।```
हालाँकि, समापन की स्क्रिप्ट bash-completion पर निर्भर हैं जिसका अर्थ है कि आपको पहले इस सॉफ़्टवेयर को इंस्टॉल करना होगा।
निम्नलिखित निर्देश मानते हैं कि आप बैश 4.1+ का उपयोग करते हैं। आप अपने बैश के संस्करण को यह चलाकर देख सकते हैं:
echo $BASH_VERSION
यदि यह बहुत पुराना है, तो आप Homebrew का उपयोग करके इसे इनस्टॉल/अपग्रेड कर सकते हैं:
brew install bash
अपने शेल को पुनः लोड करें और सत्यापित करें कि इच्छित संस्करण का उपयोग किया जा रहा है:
echo $BASH_VERSION $SHELL
Homebrew आमतौर पर इसे /usr/local/bin/bash पर इनस्टॉल करता है।
आप type_init_completion से सत्यापित कर सकते हैं कि क्या आपके पास bash-completion v2 पहले से इनस्टॉल है। यदि नहीं, तो आप इसे Homebrew से इनस्टॉल कर सकते हैं
brew install bash-completion@2
जैसा कि इस कमांड के आउटपुट में बताया गया है, अपनी ~/.bash_profile फ़ाइल में निम्नलिखित जोड़ें:
export BASH_COMPLETION_COMPAT_DIR="/usr/local/etc/bash_completion.d"
[[ -r "/usr/local/etc/profile.d/bash_completion.sh" ]] && . "/usr/local/etc/profile.d/bash_completion.sh"
अपने शेल को पुनः लोड करें और type_init_completion से सत्यापित करें कि bash-completion v2 सही ढंग से इनस्टॉल है।
अब आपको यह सुनिश्चित करने की आवश्यकता है कि kubectl समापन स्क्रिप्ट आपके सभी शेल सत्रों (sourced) में प्राप्त हो जाए। इसे हासिल करने के कई तरीके हैं:
अपने कम्पलीशन स्क्रिप्ट को ~/.bash_profile में सोर्स करें:
echo 'source <(kubectl completion bash)' >>~/.bash_profile
कम्पलीशन स्क्रिप्ट को /usr/local/etc/bash_completion.d डायरेक्टरी में जोड़ें:
kubectl completion bash >/usr/local/etc/bash_completion.d/kubectl
यदि आपके पास kubectl के लिए एक नाम (alias) है, तो आप उस उपनाम के साथ काम करने के लिए शेल कम्पलीशन को बढ़ा सकते हैं:
echo 'alias k=kubectl' >>~/.bash_profile
echo 'complete -F __start_kubectl k' >>~/.bash_profile
यदि आपने Homebrew के साथ kubectl इनस्टॉल किया है (जैसा कि यहां बताया गया है), तो kubectl कम्पलीशन स्क्रिप्ट पहले से ही /usr/local/etc/bash_completion.d/kubectl में होनी चाहिए। ऐसे में आपको कुछ भी करने की जरूरत नहीं है।
BASH_COMPLETION_COMPAT_DIR डायरेक्टरी में सोर्स कर देता है। इसलिए आखरी दो तरीके काम करते हैं।Zsh के लिए kubectl कम्पलीशन स्क्रिप्ट kubectl completion zsh कमांड के साथ उत्पन्न की जा सकती है। आपके शेल में कम्पलीशन स्क्रिप्ट को सोर्स करने से kubectl ऑटो-कम्पलीशन सक्षम हो जाती है।
अपने सभी शेल सत्रों में ऐसा करने के लिए, निम्नलिखित को अपनी ~/.zshrc फ़ाइल में जोड़ें:
source <(kubectl completion zsh)
यदि आपके पास kubectl के लिए एक उपनाम है, तो आप उस उपनाम के साथ काम करने के लिए शेल कम्पलीशन को बढ़ा सकते हैं:
echo 'alias k=kubectl' >>~/.zshrc
echo 'complete -F __start_kubectl k' >>~/.zshrc
अपने शेल को पुनः लोड करने के बाद, kubectl ऑटो-कम्पलीशन कार्य करना चाहिए।
यदि आपको कोई त्रुटि मिलती है जैसे complete:13: command not found: compdef, तो अपनी ~/.zshrc फ़ाइल की शुरुआत में निम्नलिखित जोड़ें:
autoload -Uz compinit
compinit
kubectl convert प्लगइन इंस्टॉल करेंकुबेरनेट्स कमांड-लाइन टूल kubectl के लिए एक प्लगइन, जो आपको विभिन्न API संस्करण के बीच मैनिफ़ेस्ट को बदलने करने की अनुमति देता है।
यह विशेष रूप से नए कुबेरनेट्स रिलीज के साथ एक गैर-बहिष्कृत API संस्करण में मैनिफेस्ट को माइग्रेट करने में सहायक हो सकता है।
अधिक जानकारी के लिए, गैर पदावनत एपिस में विस्थापित करें पर जाएं।
इस कमांड से नवीनतम रिलीज डाउनलोड करें:
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/amd64/kubectl-convert"
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/arm64/kubectl-convert"
बाइनरी को मान्य करें (वैकल्पिक)
kubectl-convert चेकसम फ़ाइल डाउनलोड करें:
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/amd64/kubectl-convert.sha256"
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/arm64/kubectl-convert.sha256"
चेकसम फ़ाइल से kubectl-convert बाइनरी को मान्य करें:
echo "$(<kubectl-convert.sha256) kubectl-convert" | shasum -a 256 --check
यदि मान्य है, तो आउटपुट है:
kubectl-convert: OK
अगर चेक फेल हो जाता है, तो sha256 nonzero स्थिति के साथ बाहर निकलता है और इस आउटपुट के समान प्रिंट करता है:
kubectl-convert: FAILED
shasum: WARNING: 1 computed checksum did NOT match
Kubectl-कन्वर्ट बाइनरी को एक्सेक्यूट करने योग्य बनाएं
chmod +x ./kubectl-convert
kubectl-convert binary बाइनरी को अपने सिस्टम PATH के फ़ाइल स्थान पर ले जाएँ।
sudo mv ./kubectl-convert /usr/local/bin/kubectl-convert
sudo chown root: /usr/local/bin/kubectl-convert
/usr/local/bin आपके पाथ एनवायरनमेंट वेरिएबल में है।सत्यापित करें कि प्लगइन सफलतापूर्वक इंस्टॉल हो गया है
kubectl convert --help
यदि आपको कोई त्रुटि नहीं दिखाई देती है, तो इसका मतलब है कि प्लगइन सफलतापूर्वक इंस्टॉल हो गया है।
आप kubectl संस्करण का उपयोग करे जो आपके क्लस्टर के एक माइनर संस्करण भीतर हो। उदाहरण के लिए, v1.33 क्लाइंट v1.32, v1.33 और v1.34 कण्ट्रोल प्लेन के साथ कम्युनिकेट कर सकते हैं। kubectl के नए संस्करण का उपयोग करने से समस्या से बचत हो सकती है।
Windows पर kubectl संस्थापित करने के लिए निम्नलिखित विधियाँ मौजूद हैं:
latest release 1.33.0 डाउनलोड करें।
या यदि आपके पास curl है, तो इस कमांड का उपयोग करें:
curl -LO https://dl.k8s.io/release/v1.33.0/bin/windows/amd64/kubectl.exe
बाइनरी को मान्य करें (वैकल्पिक)
kubectl चेकसम फाइल डाउनलोड करें:
curl -LO https://dl.k8s.io/v1.33.0/bin/windows/amd64/kubectl.exe.sha256
चेकसम फ़ाइल से kubectl बाइनरी को मान्य करें:
मैन्युअल रूप से कमांड प्रॉम्प्ट का उपयोग करके CertUtil के आउटपुट की तुलना डाउनलोडेड चेकसम फ़ाइल से करें:
CertUtil -hashfile kubectl.exe SHA256
type kubectl.exe.sha256
True या False परिणाम प्राप्त करने के लिए -eq ऑपरेटर का उपयोग करके सत्यापन को ऑटोमेट करने के लिए powershell का उपयोग करें:
$(Get-FileHash -Algorithm SHA256 .\kubectl.exe).Hash -eq $(Get-Content .\kubectl.exe.sha256)
अपने PATH में बाइनरी जोड़ें।
यह सुनिश्चित करने के लिए परीक्षण करें कि kubectl संस्करण डाउनलोड के समान है:
kubectl version --client
kubectl का अपना संस्करण PATH में जोड़ता है।
यदि आपने पहले Docker Desktop स्थापित किया है, तो आपको Docker Desktop इंस्टॉलर द्वारा जोड़े गए एक PATH से पहले अपनी PATH प्रविष्टि डालने की आवश्यकता हो सकती है या Docker Desktop के kubectl को हटा दें।Windows पर kubectl इंस्टॉल करने के लिए आप या तो Chocolatey पैकेज मैनेजर अथवा Scoop कमांड-लाइन इंस्टॉलर का उपयोग कर सकते हैं।
choco install kubernetes-cli
scoop install kubectl
यह सुनिश्चित करने के लिए परीक्षण करें कि आपके द्वारा इंस्टॉल किया गया संस्करण उप-टू-डेट है:
kubectl version --client
अपनी होम डायरेक्टरी पर जाएं:
# यदि आप cmd.exe का प्रयोग कर रहे हैं, तो: cd %USERPROFILE%
cd ~
.kube डायरेक्टरी बनाएं:
mkdir .kube
आपके द्वारा अभी बनाई गई .kube डायरेक्टरी में जाएं:
cd .kube
दूरस्थ कुबेरनेट्स क्लस्टर का उपयोग करने के लिए kubectl को कॉन्फ़िगर करें:
New-Item config -type file
kubectl को कुबेरनेट्स क्लस्टर को खोजने और एक्सेस करने के लिए, उसे
क्यूबकॉन्फिग फाइल(kubeconfig) की आवश्यकता होती है,
जो स्वचालित रूप से तब बनता है जब आप
kube-up.sh का उपयोग करके क्लस्टर बनाते हैं
या मिनीक्यूब क्लस्टर को सफलतापूर्वक डिप्लॉय करते हैं।
डिफ़ॉल्ट रूप से, kubectl कॉन्फ़िगरेशन ~/.kube/config पर स्थित होता है।
जाँच करें कि क्लस्टर स्टेट प्राप्त करके kubectl को ठीक से कॉन्फ़िगर किया गया है:
kubectl cluster-info
यदि आपको एक URL प्रतिक्रिया दिखती हैं, तो kubectl आपके क्लस्टर तक पहुँचने के लिए सही ढंग से कॉन्फ़िगर हुआ है।
यदि आपको निम्नलिखित संदेश दिखाई देता है, तो kubectl ठीक से कॉन्फ़िगर नहीं हुआ है या कुबेरनेट्स क्लस्टर से कनेक्ट करने में सक्षम नहीं है।
The connection to the server <server-name:port> was refused - did you specify the right host or port?
उदाहरण के लिए, यदि आप अपने लैपटॉप (स्थानीय रूप से) पर कुबेरनेट्स क्लस्टर चलाना चाहते हैं, तो आपको पहले मिनीक्यूब (minikube) जैसे टूल को इंस्टॉल करना होगा और ऊपर बताए गए कमांड को फिर से चलाना होगा।
यदि kubectl cluster-info URL प्रतिक्रिया देता है, लेकिन आप अपने क्लस्टर को एक्सेस नहीं कर पा रहें हैं, तो यह जाँचने के लिए कि क्या यह ठीक से कॉन्फ़िगर किया गया है, इस कमांड का उपयोग करें:
kubectl cluster-info dump
kubectl Bash और Zsh के लिए ऑटोकम्प्लेशन का सपोर्ट प्रदान करता है, जो आपको बहुत सारी टाइपिंग बचा सकता है।
नीचे Zsh के लिए ऑटोकम्प्लेशन स्थापित करने की प्रक्रियाएँ हैं, यदि आप इसे Windows पर चला रहे हैं।
Zsh के लिए kubectl कम्पलीशन स्क्रिप्ट kubectl completion zsh कमांड के साथ उत्पन्न की जा सकती है। आपके शेल में कम्पलीशन स्क्रिप्ट को सोर्स करने से kubectl ऑटो-कम्पलीशन सक्षम हो जाती है।
अपने सभी शेल सत्रों में ऐसा करने के लिए, निम्नलिखित को अपनी ~/.zshrc फ़ाइल में जोड़ें:
source <(kubectl completion zsh)
यदि आपके पास kubectl के लिए एक उपनाम है, तो आप उस उपनाम के साथ काम करने के लिए शेल कम्पलीशन को बढ़ा सकते हैं:
echo 'alias k=kubectl' >>~/.zshrc
echo 'complete -F __start_kubectl k' >>~/.zshrc
अपने शेल को पुनः लोड करने के बाद, kubectl ऑटो-कम्पलीशन कार्य करना चाहिए।
यदि आपको कोई त्रुटि मिलती है जैसे complete:13: command not found: compdef, तो अपनी ~/.zshrc फ़ाइल की शुरुआत में निम्नलिखित जोड़ें:
autoload -Uz compinit
compinit
kubectl convert प्लगइनकुबेरनेट्स कमांड-लाइन टूल kubectl के लिए एक प्लगइन, जो आपको विभिन्न API संस्करण के बीच मैनिफ़ेस्ट को बदलने करने की अनुमति देता है।
यह विशेष रूप से नए कुबेरनेट्स रिलीज के साथ एक गैर-बहिष्कृत API संस्करण में मैनिफेस्ट को माइग्रेट करने में सहायक हो सकता है।
अधिक जानकारी के लिए, गैर पदावनत एपिस में विस्थापित करें पर जाएं।
इस कमांड से नवीनतम रिलीज डाउनलोड करें:
curl -LO https://dl.k8s.io/release/v1.33.0/bin/windows/amd64/kubectl-convert.exe
बाइनरी को मान्य करें (वैकल्पिक)
kubectl-convert चेकसम फ़ाइल डाउनलोड करें:
curl -LO https://dl.k8s.io/v1.33.0/bin/windows/amd64/kubectl-convert.exe.sha256
चेकसम फ़ाइल से kubectl-convert बाइनरी को मान्य करें:
मैन्युअल रूप से कमांड प्रॉम्प्ट का उपयोग करके CertUtil के आउटपुट की तुलना डाउनलोड किये गये चेकसम फ़ाइल से करें:
CertUtil -hashfile kubectl-convert.exe SHA256
type kubectl-convert.exe.sha256
True या False परिणाम प्राप्त करने और -eq ऑपरेटर का उपयोग करके सत्यापन को ऑटोमेट करने के लिए Powershell का उपयोग करें:
$($(CertUtil -hashfile .\kubectl-convert.exe SHA256)[1] -replace " ", "") -eq $(type .\kubectl-convert.exe.sha256)
अपने PATH में बाइनरी जोड़ें।
सत्यापित करें कि प्लगइन सफलतापूर्वक इंस्टॉल हो गया है।
kubectl convert --help
यदि आपको कोई त्रुटि नहीं दिखाई देती है, तो इसका मतलब है कि प्लगइन सफलतापूर्वक इंस्टॉल हो गया है।
यह पृष्ठ दिखाता है कि क्यूबलेट के लिए प्रमाणपत्र आवर्तन कैसे सक्षम और कॉन्फ़िगर कर सकते है।
Kubernetes v1.19 [stable]
क्यूबलेट प्रमाणपत्रों का उपयोग कुबरनेट्स API के साथ प्रमाणित करने के लिए करता है। डिफ़ॉल्ट रूप से, ये प्रमाणपत्र एक वर्ष की समाप्ति के साथ जारी किए जाते हैं ताकि उन्हें बार-बार नवीनीकृत करने की आवश्यकता न हो।
कुबरनेट्स में क्यूबलेट प्रमाणपत्र आवर्तन शामिल है, जो स्वचालित रूप से एक नई कुंजी उत्पन्न करेगा जो स्वचालित रूप से एक नई कुंजी उत्पन्न करेगा और वर्तमान प्रमाणपत्र की समाप्ति के करीब आने पर कुबरनेट्स API से एक नया प्रमाणपत्र अनुरोध करेगा। एक बार नया प्रमाणपत्र उपलब्ध हो जाने पर, यह कुबरनेट्स API के साथ कनेक्शन को प्रमाणित करने के लिए उपयोग किया जाएगा।
kubelet प्रक्रिया एक प्राचल --rotate-certificates स्वीकार करती है जो नियंत्रित करती है कि क्या कुबलेट स्वचालित रूप से वर्तमान में उपयोग किए जा रहे प्रमाणपत्र की समाप्ति के करीब आने पर एक नया प्रमाणपत्र अनुरोध करेगा।
kube-controller-manager प्रक्रिया एक प्राचल स्वीकार करती है
--cluster-signing-duration (--experimental-cluster-signing-duration 1.19 से पहले)
जो नियंत्रित करता है कि प्रमाणपत्र कितने समय के लिए जारी किए जाएंगे।
जब एक कुबलेट शुरू होता है, यदि इसे बूटस्ट्रैप करने के लिए कॉन्फ़िगर किया गया है (उपयोग करते हुए
--bootstrap-kubeconfig फ्लैग), तो यह कुबरनेट्स API से कनेक्ट करने और एक प्रमाणपत्र हस्ताक्षर अनुरोध जारी करने के लिए अपने प्रारंभिक प्रमाणपत्र का उपयोग करेगा। आप प्रमाणपत्र हस्ताक्षर अनुरोधों की स्थिति देख सकते हैं:
kubectl get csr
शुरुआत में, किसी नोड पर कुबलेट से एक प्रमाणपत्र हस्ताक्षर अनुरोध की स्थिति Pending होगी।
यदि प्रमाणपत्र हस्ताक्षर अनुरोध विशिष्ट मानदंडों को पूरा करता है, तो इसे नियंत्रक प्रबंधक द्वारा स्वचालित रूप से अनुमोदित किया जाएगा, और फिर इसकी स्थिति Approved होगी।
इसके बाद, नियंत्रक प्रबंधक एक प्रमाणपत्र पर हस्ताक्षर करेगा, जो
--cluster-signing-duration पैरामीटर द्वारा निर्दिष्ट अवधि के लिए जारी किया जाएगा, और हस्ताक्षरित प्रमाणपत्र को प्रमाणपत्र हस्ताक्षर अनुरोध से जोड़ा जाएगा।
कुबलेट कुबरनेट्स API से हस्ताक्षरित प्रमाणपत्र प्राप्त करेगा और इसे डिस्क पर लिखेगा,
--cert-dir द्वारा निर्दिष्ट स्थान में। फिर कुबलेट कुबरनेट्स API से कनेक्ट करने के लिए नए प्रमाणपत्र का उपयोग करेगा।
जैसे ही हस्ताक्षरित प्रमाणपत्र की समाप्ति निकट आती है, कुबलेट स्वचालित रूप से कुबरनेट्स API का उपयोग करके एक नया प्रमाणपत्र हस्ताक्षर अनुरोध जारी करेगा। यह प्रमाणपत्र पर शेष समय के 30% और 10% के बीच किसी भी बिंदु पर हो सकता है। फिर से, नियंत्रक प्रबंधक स्वचालित रूप से प्रमाणपत्र अनुरोध को अनुमोदित करेगा और प्रमाणपत्र हस्ताक्षर अनुरोध से एक हस्ताक्षरित प्रमाणपत्र जोड़ेगा। कुबलेट कुबरनेट्स API से नया हस्ताक्षरित प्रमाणपत्र प्राप्त करेगा और इसे डिस्क पर लिखेगा। फिर यह कुबरनेट्स API के साथ कनेक्शन को नए प्रमाणपत्र का उपयोग करके पुन: कनेक्ट करने के लिए अपडेट करेगा।
यह गाइड आपको kubectl के लिए एक्सटेंशन कैसे इंस्टॉल और लिखें, यह दिखाती है।
मुख्य kubectl कमांड्स को कुबेरनेट्स क्लस्टर के साथ इंटरैक्ट करने के लिए आवश्यक बिल्डिंग ब्लॉक्स के रूप में सोचकर,
एक क्लस्टर एडमिनिस्ट्रेटर प्लगइन्स को अधिक जटिल व्यवहार बनाने के लिए इन बिल्डिंग ब्लॉक्स का उपयोग करने का एक साधन मान सकता है।
प्लगइन्स kubectl को नए सब-कमांड्स के साथ विस्तारित करते हैं, जो kubectl के मुख्य वितरण में शामिल नहीं की गई नई और कस्टम सुविधाओं को सक्षम बनाते हैं।
आपके पास एक कार्यशील kubectl बाइनरी इंस्टॉल होना चाहिए।
एक प्लगइन एक स्टैंडअलोन एक्जीक्यूटेबल फाइल है, जिसका नाम kubectl- से शुरू होता है। प्लगइन को इंस्टॉल करने के लिए, इसकी एक्जीक्यूटेबल फाइल को अपने PATH में कहीं भी मूव करें।
आप Krew का उपयोग करके ओपन सोर्स में उपलब्ध kubectl प्लगइन्स को भी खोज और इंस्टॉल कर सकते हैं। Krew एक प्लगइन मैनेजर है जो कुबेरनेट्स SIG CLI कम्युनिटी द्वारा मेंटेन किया जाता है।
kubectl एक कमांड kubectl plugin list प्रदान करता है जो आपके PATH में वैध प्लगइन एक्जीक्यूटेबल्स की खोज करता है।
इस कमांड को एक्जीक्यूट करने से आपके PATH में सभी फाइलों का ट्रैवर्सल होता है। कोई भी फाइल जो एक्जीक्यूटेबल है और
kubectl- से शुरू होती है, वह इस कमांड के आउटपुट में आपके PATH में मौजूद क्रम में दिखाई देगी।
kubectl- से शुरू होने वाली किसी भी फाइल के लिए एक चेतावनी शामिल की जाएगी जो एक्जीक्यूटेबल नहीं है।
ऐसी किसी भी वैध प्लगइन फाइल के लिए भी एक चेतावनी शामिल की जाएगी जो एक-दूसरे के नाम को ओवरलैप करती हैं।
आप Krew का उपयोग कम्युनिटी द्वारा क्यूरेट किए गए plugin index से kubectl प्लगइन्स को खोजने और इंस्टॉल करने के लिए कर सकते हैं।
kubectl प्लगइन्स को PATH में kubectl-create-something बाइनरी प्रदान करके kubectl create something के आकार में कस्टम क्रिएट कमांड्स जोड़ने की अनुमति देता है।
वर्तमान में मौजूदा kubectl कमांड्स को ओवरराइट करने या create के अलावा अन्य कमांड्स को विस्तारित करने वाले प्लगइन बनाना संभव नहीं है।
उदाहरण के लिए, एक प्लगइन kubectl-version बनाने से वह प्लगइन कभी भी एक्जीक्यूट नहीं होगा, क्योंकि मौजूदा kubectl version
कमांड हमेशा इसकी तुलना में प्राथमिकता लेगा।
इस सीमा के कारण, मौजूदा kubectl कमांड्स में नए सबकमांड जोड़ने के लिए प्लगइन्स का उपयोग करना भी संभव नहीं है।
उदाहरण के लिए, अपने प्लगइन का नाम kubectl-attach-vm रखकर एक सबकमांड kubectl attach vm जोड़ने से वह प्लगइन नजरअंदाज कर दिया जाएगा।
kubectl plugin list ऐसा करने का प्रयास करने वाले किसी भी वैध प्लगइन के लिए चेतावनियां दिखाता है।
आप किसी भी प्रोग्रामिंग भाषा या स्क्रिप्ट में प्लगइन लिख सकते हैं जो आपको कमांड-लाइन कमांड्स लिखने की अनुमति देती है।
कोई प्लगइन इंस्टॉलेशन या पूर्व-लोडिंग आवश्यक नहीं है। प्लगइन एक्जीक्यूटेबल्स को kubectl बाइनरी से विरासत में मिला पर्यावरण प्राप्त होता है।
एक प्लगइन अपने नाम के आधार पर तय करता है कि वह किस कमांड पाथ को लागू करना चाहता है।
उदाहरण के लिए, kubectl-foo नाम का एक प्लगइन kubectl foo कमांड प्रदान करता है। आपको
प्लगइन एक्जीक्यूटेबल को अपने PATH में कहीं भी इंस्टॉल करना होगा।
#!/bin/bash
# वैकल्पिक आर्गुमेंट हैंडलिंग
if [[ "$1" == "version" ]]
then
echo "1.0.0"
exit 0
fi
# वैकल्पिक आर्गुमेंट हैंडलिंग
if [[ "$1" == "config" ]]
then
echo "$KUBECONFIG"
exit 0
fi
echo "मैं kubectl-foo नाम का एक प्लगइन हूं"
प्लगइन का उपयोग करने के लिए, प्लगइन को एक्जीक्यूटेबल बनाएं:
sudo chmod +x ./kubectl-foo
और इसे अपने PATH में कहीं भी रखें:
sudo mv ./kubectl-foo /usr/local/bin
अब आप अपने प्लगइन को एक kubectl कमांड के रूप में इनवोक कर सकते हैं:
kubectl foo
मैं kubectl-foo नाम का एक प्लगइन हूं
सभी आर्ग्स और फ्लैग्स जैसे के तैसे एक्जीक्यूटेबल को पास किए जाते हैं:
kubectl foo version
1.0.0
सभी एनवायरनमेंट वेरिएबल्स भी जैसे के तैसे एक्जीक्यूटेबल को पास किए जाते हैं:
export KUBECONFIG=~/.kube/config
kubectl foo config
/home/<user>/.kube/config
KUBECONFIG=/etc/kube/config kubectl foo config
/etc/kube/config
इसके अतिरिक्त, प्लगइन को पास किया जाने वाला पहला आर्गुमेंट हमेशा उस स्थान का पूर्ण पाथ होगा जहां से इसे इनवोक किया गया था (ऊपर के उदाहरण में $0 /usr/local/bin/kubectl-foo के बराबर होगा)।
जैसा कि ऊपर के उदाहरण में देखा गया है, एक प्लगइन अपने फाइलनेम के आधार पर तय करता है कि वह किस कमांड पाथ को लागू करेगा। कमांड पाथ में प्रत्येक सब-कमांड को डैश (-) से अलग किया जाता है।
उदाहरण के लिए, एक प्लगइन जो यूजर द्वारा kubectl foo bar baz कमांड इनवोक किए जाने पर चलाया जाना चाहता है, उसका फाइलनेम kubectl-foo-bar-baz होगा।
प्लगइन मैकेनिज्म प्लगइन प्रोसेस के लिए कोई कस्टम, प्लगइन-विशिष्ट वैल्यू या एनवायरनमेंट वेरिएबल्स नहीं बनाता है।
एक पुराना kubectl प्लगइन मैकेनिज्म KUBECTL_PLUGINS_CURRENT_NAMESPACE जैसे एनवायरनमेंट वेरिएबल्स प्रदान करता था; अब ऐसा नहीं होता है।
kubectl प्लगइन्स को उन्हें पास किए गए सभी आर्गुमेंट्स को पार्स और वैलिडेट करना होगा। विवरण के लिए प्लगइन लेखकों के लिए लक्षित Go लाइब्रेरी के बारे में कमांड लाइन रनटाइम पैकेज का उपयोग करना देखें।
यहाँ कुछ अतिरिक्त मामले हैं जहाँ यूजर्स अतिरिक्त फ्लैग्स और आर्गुमेंट्स प्रदान करते हुए आपके प्लगइन को इनवोक करते हैं। यह ऊपर के परिदृश्य से kubectl-foo-bar-baz प्लगइन पर आधारित है।
यदि आप kubectl foo bar baz arg1 --flag=value arg2 चलाते हैं, तो kubectl का प्लगइन मैकेनिज्म पहले सबसे लंबे संभावित नाम वाले प्लगइन को खोजने का प्रयास करेगा, जो इस मामले में
kubectl-foo-bar-baz-arg1 होगा। उस प्लगइन को न पाने पर, kubectl फिर अंतिम डैश-सेपरेटेड वैल्यू को एक आर्गुमेंट के रूप में मानता है (इस मामले में arg1), और अगले सबसे लंबे संभावित नाम को खोजने का प्रयास करता है, kubectl-foo-bar-baz।
इस नाम वाले प्लगइन को पाने पर, kubectl फिर उस प्लगइन को इनवोक करता है, प्लगइन के नाम के बाद के सभी आर्ग्स और फ्लैग्स को प्लगइन प्रोसेस को आर्गुमेंट के रूप में पास करता है।
उदाहरण:
# create a plugin
echo -e '#!/bin/bash\n\necho "My first command-line argument was $1"' > kubectl-foo-bar-baz
sudo chmod +x ./kubectl-foo-bar-baz
# "install" your plugin by moving it to a directory in your $PATH
sudo mv ./kubectl-foo-bar-baz /usr/local/bin
# check that kubectl recognizes your plugin
kubectl plugin list
निम्नलिखित kubectl-कम्पैटिबल प्लगइन्स उपलब्ध हैं:
/usr/local/bin/kubectl-foo-bar-baz
# test that calling your plugin via a "kubectl" command works
# even when additional arguments and flags are passed to your
# plugin executable by the user.
kubectl foo bar baz arg1 --meaningless-flag=true
मेरा पहला कमांड-लाइन आर्गुमेंट था arg1
जैसा कि आप देख सकते हैं, आपका प्लगइन यूजर द्वारा निर्दिष्ट kubectl कमांड के आधार पर पाया गया, और सभी अतिरिक्त आर्गुमेंट्स और फ्लैग्स जैसे के तैसे प्लगइन एक्जीक्यूटेबल को पास कर दिए गए एक बार जब वह मिल गया।
हालांकि kubectl प्लगइन मैकेनिज्म प्लगइन फाइलनेम में डैश (-) का उपयोग प्लगइन द्वारा प्रोसेस किए जाने वाले सब-कमांड्स के क्रम को अलग करने के लिए करता है, फिर भी अंडरस्कोर (_) का उपयोग करके अपने फाइलनेम में डैश वाले कमांडलाइन इनवोकेशन वाला प्लगइन बनाना संभव है।
उदाहरण:
# create a plugin containing an underscore in its filename
echo -e '#!/bin/bash\n\necho "I am a plugin with a dash in my name"' > ./kubectl-foo_bar
sudo chmod +x ./kubectl-foo_bar
# move the plugin into your $PATH
sudo mv ./kubectl-foo_bar /usr/local/bin
# You can now invoke your plugin via kubectl:
kubectl foo-bar
मैं अपने नाम में डैश वाला एक प्लगइन हूं
ध्यान दें कि प्लगइन फाइलनेम में अंडरस्कोर का प्रयोग आपको kubectl foo_bar जैसे कमांड्स से नहीं रोकता है। ऊपर के उदाहरण का कमांड, डैश (-) या अंडरस्कोर (_) दोनों का उपयोग करके इनवोक किया जा सकता है:
# You can invoke your custom command with a dash
kubectl foo-bar
मैं अपने नाम में डैश वाला एक प्लगइन हूं
# You can also invoke your custom command with an underscore
kubectl foo_bar
मैं अपने नाम में डैश वाला एक प्लगइन हूं
आपके PATH में विभिन्न स्थानों पर एक ही फाइलनेम वाले कई प्लगइन होना संभव है। उदाहरण के लिए, निम्नलिखित मान वाले PATH के लिए: PATH=/usr/local/bin/plugins:/usr/local/bin/moreplugins, प्लगइन kubectl-foo की एक कॉपी /usr/local/bin/plugins और /usr/local/bin/moreplugins में मौजूद हो सकती है, ताकि kubectl plugin list कमांड का आउटपुट हो:
PATH=/usr/local/bin/plugins:/usr/local/bin/moreplugins kubectl plugin list
The following kubectl-compatible plugins are available:
/usr/local/bin/plugins/kubectl-foo
/usr/local/bin/moreplugins/kubectl-foo
- warning: /usr/local/bin/moreplugins/kubectl-foo is overshadowed by a similarly named plugin: /usr/local/bin/plugins/kubectl-foo
error: one plugin warning was found
उपरोक्त परिदृश्य में, /usr/local/bin/moreplugins/kubectl-foo के नीचे की चेतावनी आपको बताती है कि यह प्लगइन कभी भी एक्जीक्यूट नहीं किया जाएगा। इसके बजाय, आपके PATH में पहले दिखाई देने वाला एक्जीक्यूटेबल, /usr/local/bin/plugins/kubectl-foo, हमेशा kubectl प्लगइन मैकेनिज्म द्वारा पहले पाया और एक्जीक्यूट किया जाएगा।
इस समस्या को हल करने का एक तरीका यह सुनिश्चित करना है कि जिस प्लगइन का उपयोग आप kubectl के साथ करना चाहते हैं, वह हमेशा आपके PATH में पहले आए। उदाहरण के लिए, यदि आप हमेशा /usr/local/bin/moreplugins/kubectl-foo का उपयोग करना चाहते हैं जब भी kubectl कमांड kubectl foo इनवोक किया जाता है, तो अपने PATH का मान /usr/local/bin/moreplugins:/usr/local/bin/plugins में बदलें।
प्लगइन फाइलनेम के साथ एक और प्रकार का ओवरशैडोइंग हो सकता है। यूजर के PATH में मौजूद दो प्लगइन्स के लिए: kubectl-foo-bar और kubectl-foo-bar-baz, kubectl प्लगइन मैकेनिज्म हमेशा दिए गए यूजर कमांड के लिए सबसे लंबा संभव प्लगइन नाम चुनेगा। नीचे दिए गए कुछ उदाहरण इसे और स्पष्ट करते हैं:
# एक दिए गए kubectl कमांड के लिए, सबसे लंबे संभव फाइलनेम वाले प्लगइन को हमेशा प्राथमिकता दी जाएगी
kubectl foo bar baz
प्लगइन kubectl-foo-bar-baz एक्जीक्यूट किया गया
kubectl foo bar
प्लगइन kubectl-foo-bar एक्जीक्यूट किया गया
kubectl foo bar baz buz
प्लगइन kubectl-foo-bar-baz एक्जीक्यूट किया गया, "buz" को इसके पहले आर्गुमेंट के रूप में
kubectl foo bar buz
प्लगइन kubectl-foo-bar एक्जीक्यूट किया गया, "buz" को इसके पहले आर्गुमेंट के रूप में
यह डिजाइन चॉइस सुनिश्चित करता है कि प्लगइन सब-कमांड्स को, यदि आवश्यक हो, कई फाइलों में लागू किया जा सकता है, और इन सब-कमांड्स को एक "पैरेंट" प्लगइन कमांड के नीचे नेस्टेड किया जा सकता है:
ls ./plugin_command_tree
kubectl-parent
kubectl-parent-subcommand
kubectl-parent-subcommand-subsubcommand
आप पूर्वोक्त kubectl plugin list कमांड का उपयोग यह सुनिश्चित करने के लिए कर सकते हैं कि आपका प्लगइन kubectl द्वारा दिखाई दे रहा है, और सत्यापित करें कि कोई चेतावनियां नहीं हैं जो इसे एक kubectl कमांड के रूप में कॉल किए जाने से रोक रही हैं।
kubectl plugin list
निम्नलिखित kubectl-कम्पैटिबल प्लगइन्स उपलब्ध हैं:
test/fixtures/pkg/kubectl/plugins/kubectl-foo
/usr/local/bin/kubectl-foo
- चेतावनी: /usr/local/bin/kubectl-foo एक समान नाम वाले प्लगइन द्वारा ओवरशैडो किया गया है: test/fixtures/pkg/kubectl/plugins/kubectl-foo
plugins/kubectl-invalid
- चेतावनी: plugins/kubectl-invalid एक kubectl प्लगइन के रूप में पहचाना गया, लेकिन यह एक्जीक्यूटेबल नहीं है
त्रुटि: 2 प्लगइन चेतावनियां पाई गईं
यदि आप kubectl के लिए एक प्लगइन लिख रहे हैं और आप Go का उपयोग कर रहे हैं, तो आप cli-runtime यूटिलिटी लाइब्रेरीज का उपयोग कर सकते हैं।
ये लाइब्रेरीज यूजर की kubeconfig फाइल को पार्स या अपडेट करने, API सर्वर को REST-स्टाइल रिक्वेस्ट भेजने, या कॉन्फ़िगरेशन और प्रिंटिंग से जुड़े फ्लैग्स को बाइंड करने के लिए हेल्पर्स प्रदान करती हैं।
CLI Runtime रेपो में प्रदान किए गए टूल्स के उपयोग के उदाहरण के लिए Sample CLI Plugin देखें।
यदि आपने दूसरों के उपयोग के लिए एक प्लगइन विकसित किया है, तो आपको इसे कैसे पैकेज करें, वितरित करें और अपने उपयोगकर्ताओं को अपडेट प्रदान करें, इस पर विचार करना चाहिए।
Krew आपके प्लगइन्स को पैकेज और वितरित करने का एक क्रॉस-प्लेटफ़ॉर्म तरीका प्रदान करता है। इस तरह, आप सभी लक्षित प्लेटफ़ॉर्म (Linux, Windows, macOS आदि) के लिए एक ही पैकेजिंग फॉर्मेट का उपयोग करते हैं और अपने उपयोगकर्ताओं को अपडेट प्रदान करते हैं। Krew एक प्लगइन इंडेक्स भी बनाए रखता है ताकि अन्य लोग आपके प्लगइन को खोज और इंस्टॉल कर सकें।
वैकल्पिक रूप से, आप पारंपरिक पैकेज मैनेजर्स जैसे Linux पर apt या yum, Windows पर Chocolatey, और macOS पर Homebrew का उपयोग कर सकते हैं। कोई भी पैकेज मैनेजर उपयुक्त होगा यदि वह नई एक्जीक्यूटेबल्स को यूजर के PATH में कहीं भी रख सकता है।
एक प्लगइन लेखक के रूप में, यदि आप यह विकल्प चुनते हैं तो आप पर प्रत्येक रिलीज के लिए कई प्लेटफ़ॉर्म पर अपने kubectl प्लगइन के वितरण पैकेज को अपडेट करने का भार भी होता है।
आप सोर्स कोड प्रकाशित कर सकते हैं; उदाहरण के लिए, एक Git रिपॉजिटरी के रूप में। यदि आप यह विकल्प चुनते हैं, तो जो कोई भी उस प्लगइन का उपयोग करना चाहता है, उसे कोड फेच करना होगा, एक बिल्ड एनवायरनमेंट सेट करना होगा (यदि कम्पाइल करने की आवश्यकता है), और प्लगइन को डिप्लॉय करना होगा। यदि आप कम्पाइल किए गए पैकेज भी उपलब्ध कराते हैं, या Krew का उपयोग करते हैं, तो यह इंस्टॉल को आसान बना देगा।