[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"page-ru-/guides/linux/setup-kubectl":3,"mdc--jj306q-key":1014,"mdc--ni1r6j-key":1024,"mdc--rkpp6-key":1041,"mdc-gdkrb9-key":1049,"mdc--n4jdjh-key":1073,"mdc--c0iu8c-key":1081,"mdc--wguckx-key":1089,"mdc--l56zrt-key":1105,"related-/guides/linux/setup-minikube,/guides/linux/install-docker-ce,/errors/linux/kubectl-command-not-found":1128},{"id":4,"title":5,"appliesTo":6,"author":11,"body":12,"canonical":950,"code":950,"createdAt":951,"description":952,"difficulty":953,"draft":954,"estimatedTime":955,"extension":956,"faq":957,"howToSteps":970,"howToTotalTime":983,"image":950,"keywords":984,"locale":993,"meta":994,"navigation":142,"path":995,"platform":996,"related":997,"section":1001,"seo":1002,"severity":950,"stem":1003,"summary":1004,"tags":1005,"twitterCreator":950,"twitterSite":950,"type":1012,"updatedAt":951,"__hash__":1013},"content_ru/guides/linux/setup-kubectl.md","Установка kubectl на Linux: полное руководство для начинающих",[7,8,9,10],"Ubuntu 20.04+","CentOS 7+/RHEL 7+","Debian 10+","Fedora 35+","FixPedia Team",{"type":13,"value":14,"toc":923},"minimark",[15,20,28,35,39,42,70,74,81,86,191,216,220,302,318,322,325,329,349,353,397,409,412,416,419,434,437,445,456,490,496,564,568,577,631,634,646,649,653,656,712,723,727,730,752,756,763,779,785,803,810,837,844,855,859,877,898,919],[16,17,19],"h2",{"id":18},"введение-зачем-это-нужно","Введение / Зачем это нужно",[21,22,23,27],"p",{},[24,25,26],"strong",{},"kubectl"," — это командная строка (CLI) для управления кластерами Kubernetes. С её помощью вы разворачиваете приложения, inspectируете состояние ресурсов, управляете конфигурацией и отлаживаете работу в кластере. Без kubectl взаимодействие с Kubernetes сводится к прямым вызовам API, что крайне неудобно.",[21,29,30,31,34],{},"После выполнения этого гайда у вас будет установлен и готовый к работе клиент ",[32,33,26],"code",{},". Вы сможете подключаться к любому кластеру Kubernetes (управляемому сервисом вроде GKE/EKS/AKS или собственным) и выполнять основные операции.",[16,36,38],{"id":37},"требования-подготовка","Требования / Подготовка",[21,40,41],{},"Перед началом убедитесь, что:",[43,44,45,53,63],"ol",{},[46,47,48,49,52],"li",{},"У вас есть доступ к терминалу Linux (Ubuntu, CentOS, Debian, Fedora и т.д.) с правами ",[24,50,51],{},"sudo",".",[46,54,55,56,59,60,52],{},"На машине установлен ",[24,57,58],{},"curl"," (обычно есть по умолчанию) или ",[24,61,62],{},"wget",[46,64,65,66,69],{},"Вы знаете URL и имеют учетные данные для доступа к целевому кластеру Kubernetes (это нужно для шага настройки ",[32,67,68],{},"kubeconfig",").",[16,71,73],{"id":72},"шаг-1-добавление-официального-репозитория-kubernetes","Шаг 1: Добавление официального репозитория Kubernetes",[21,75,76,77,80],{},"Рекомендуемый способ установки — через официальный репозиторий ",[32,78,79],{},"pkgs.k8s.io",". Это гарантирует получение актуальных и проверенных версий.",[82,83,85],"h3",{"id":84},"для-дистрибутивов-на-базе-debianubuntu-apt","Для дистрибутивов на базе Debian/Ubuntu (apt):",[87,88,93],"pre",{"className":89,"code":90,"language":91,"meta":92,"style":92},"language-bash shiki shiki-themes github-light github-dark","# 1. Скачайте и добавьте GPG-ключ репозитория\ncurl -fsSL https://pkgs.k8s.io/core:/stable:/v1.28/deb/Release.key | sudo gpg --dearmor -o /etc/apt/keyrings/kubernetes-apt-keyring.gpg\n\n# 2. Добавьте сам репозиторий в sources.list.d\necho 'deb [signed-by=/etc/apt/keyrings/kubernetes-apt-keyring.gpg] https://pkgs.k8s.io/core:/stable:/v1.28/deb/ /' | sudo tee /etc/apt/sources.list.d/kubernetes.list\n\n# 3. Обновите кэш пакетов\nsudo apt-get update\n","bash","",[32,94,95,104,137,144,150,169,174,180],{"__ignoreMap":92},[96,97,100],"span",{"class":98,"line":99},"line",1,[96,101,103],{"class":102},"sJ8bj","# 1. Скачайте и добавьте GPG-ключ репозитория\n",[96,105,107,110,114,118,122,125,128,131,134],{"class":98,"line":106},2,[96,108,58],{"class":109},"sScJk",[96,111,113],{"class":112},"sj4cs"," -fsSL",[96,115,117],{"class":116},"sZZnC"," https://pkgs.k8s.io/core:/stable:/v1.28/deb/Release.key",[96,119,121],{"class":120},"szBVR"," |",[96,123,124],{"class":109}," sudo",[96,126,127],{"class":116}," gpg",[96,129,130],{"class":112}," --dearmor",[96,132,133],{"class":112}," -o",[96,135,136],{"class":116}," /etc/apt/keyrings/kubernetes-apt-keyring.gpg\n",[96,138,140],{"class":98,"line":139},3,[96,141,143],{"emptyLinePlaceholder":142},true,"\n",[96,145,147],{"class":98,"line":146},4,[96,148,149],{"class":102},"# 2. Добавьте сам репозиторий в sources.list.d\n",[96,151,153,156,159,161,163,166],{"class":98,"line":152},5,[96,154,155],{"class":112},"echo",[96,157,158],{"class":116}," 'deb [signed-by=/etc/apt/keyrings/kubernetes-apt-keyring.gpg] https://pkgs.k8s.io/core:/stable:/v1.28/deb/ /'",[96,160,121],{"class":120},[96,162,124],{"class":109},[96,164,165],{"class":116}," tee",[96,167,168],{"class":116}," /etc/apt/sources.list.d/kubernetes.list\n",[96,170,172],{"class":98,"line":171},6,[96,173,143],{"emptyLinePlaceholder":142},[96,175,177],{"class":98,"line":176},7,[96,178,179],{"class":102},"# 3. Обновите кэш пакетов\n",[96,181,183,185,188],{"class":98,"line":182},8,[96,184,51],{"class":109},[96,186,187],{"class":116}," apt-get",[96,189,190],{"class":116}," update\n",[192,193,194],"blockquote",{},[21,195,196,197,200,201,204,205,208,209,52],{},"💡 ",[24,198,199],{},"Совет:"," Замените ",[32,202,203],{},"v1.28"," в URL на нужную вам минорную версию Kubernetes (например, ",[32,206,207],{},"v1.29","). Актуальную версию можно уточнить на ",[210,211,215],"a",{"href":212,"rel":213},"https://kubernetes.io/releases/",[214],"nofollow","странице релизов",[82,217,219],{"id":218},"для-дистрибутивов-на-базе-rhelcentosfedora-yumdnf","Для дистрибутивов на базе RHEL/CentOS/Fedora (yum/dnf):",[87,221,223],{"className":89,"code":222,"language":91,"meta":92,"style":92},"# 1. Создайте файл репозитория\nsudo tee /etc/yum.repos.d/kubernetes.repo \u003C\u003CEOF\n[kubernetes]\nname=Kubernetes\nbaseurl=https://pkgs.k8s.io/core:/stable:/v1.28/rpm/\nenabled=1\ngpgcheck=1\ngpgkey=https://pkgs.k8s.io/core:/stable:/v1.28/rpm/repodata/repomd.xml.key\nEOF\n\n# 2. Обновите кэш репозитория (для CentOS/RHEL 7 может потребоваться включить модуль)\nsudo yum makecache\n",[32,224,225,230,245,250,255,260,265,270,275,280,285,291],{"__ignoreMap":92},[96,226,227],{"class":98,"line":99},[96,228,229],{"class":102},"# 1. Создайте файл репозитория\n",[96,231,232,234,236,239,242],{"class":98,"line":106},[96,233,51],{"class":109},[96,235,165],{"class":116},[96,237,238],{"class":116}," /etc/yum.repos.d/kubernetes.repo",[96,240,241],{"class":120}," \u003C\u003C",[96,243,244],{"class":116},"EOF\n",[96,246,247],{"class":98,"line":139},[96,248,249],{"class":116},"[kubernetes]\n",[96,251,252],{"class":98,"line":146},[96,253,254],{"class":116},"name=Kubernetes\n",[96,256,257],{"class":98,"line":152},[96,258,259],{"class":116},"baseurl=https://pkgs.k8s.io/core:/stable:/v1.28/rpm/\n",[96,261,262],{"class":98,"line":171},[96,263,264],{"class":116},"enabled=1\n",[96,266,267],{"class":98,"line":176},[96,268,269],{"class":116},"gpgcheck=1\n",[96,271,272],{"class":98,"line":182},[96,273,274],{"class":116},"gpgkey=https://pkgs.k8s.io/core:/stable:/v1.28/rpm/repodata/repomd.xml.key\n",[96,276,278],{"class":98,"line":277},9,[96,279,244],{"class":116},[96,281,283],{"class":98,"line":282},10,[96,284,143],{"emptyLinePlaceholder":142},[96,286,288],{"class":98,"line":287},11,[96,289,290],{"class":102},"# 2. Обновите кэш репозитория (для CentOS/RHEL 7 может потребоваться включить модуль)\n",[96,292,294,296,299],{"class":98,"line":293},12,[96,295,51],{"class":109},[96,297,298],{"class":116}," yum",[96,300,301],{"class":116}," makecache\n",[192,303,304],{},[21,305,306,307,310,311,314,315,52],{},"⚠️ ",[24,308,309],{},"Важно:"," Для CentOS/RHEL 7 может потребоваться явное включение модуля: ",[32,312,313],{},"sudo yum module enable -n containerd"," или ",[32,316,317],{},"sudo yum install -y containerd",[16,319,321],{"id":320},"шаг-2-установка-пакета-kubectl","Шаг 2: Установка пакета kubectl",[21,323,324],{},"Теперь, когда репозиторий добавлен, установите сам пакет.",[82,326,328],{"id":327},"для-apt-ubuntudebian","Для apt (Ubuntu/Debian):",[87,330,332],{"className":89,"code":331,"language":91,"meta":92,"style":92},"sudo apt-get install -y kubectl\n",[32,333,334],{"__ignoreMap":92},[96,335,336,338,340,343,346],{"class":98,"line":99},[96,337,51],{"class":109},[96,339,187],{"class":116},[96,341,342],{"class":116}," install",[96,344,345],{"class":112}," -y",[96,347,348],{"class":116}," kubectl\n",[82,350,352],{"id":351},"для-yumdnf-centosrhelfedora","Для yum/dnf (CentOS/RHEL/Fedora):",[87,354,356],{"className":89,"code":355,"language":91,"meta":92,"style":92},"# На CentOS/RHEL 7 используйте yum\nsudo yum install -y kubectl\n\n# На Fedora и более новых RHEL/CentOS используйте dnf\nsudo dnf install -y kubectl\n",[32,357,358,363,375,379,384],{"__ignoreMap":92},[96,359,360],{"class":98,"line":99},[96,361,362],{"class":102},"# На CentOS/RHEL 7 используйте yum\n",[96,364,365,367,369,371,373],{"class":98,"line":106},[96,366,51],{"class":109},[96,368,298],{"class":116},[96,370,342],{"class":116},[96,372,345],{"class":112},[96,374,348],{"class":116},[96,376,377],{"class":98,"line":139},[96,378,143],{"emptyLinePlaceholder":142},[96,380,381],{"class":98,"line":146},[96,382,383],{"class":102},"# На Fedora и более новых RHEL/CentOS используйте dnf\n",[96,385,386,388,391,393,395],{"class":98,"line":152},[96,387,51],{"class":109},[96,389,390],{"class":116}," dnf",[96,392,342],{"class":116},[96,394,345],{"class":112},[96,396,348],{"class":116},[21,398,399,400,402,403,314,406,69],{},"Команда установит бинарный файл ",[32,401,26],{}," в системный каталог (обычно ",[32,404,405],{},"/usr/local/bin",[32,407,408],{},"/usr/bin",[410,411],"in-article-ad",{},[16,413,415],{"id":414},"шаг-3-проверка-установки-и-настройка-автодополнения","Шаг 3: Проверка установки и настройка автодополнения",[21,417,418],{},"Убедитесь, что установка прошла успешно:",[87,420,422],{"className":89,"code":421,"language":91,"meta":92,"style":92},"kubectl version --client\n",[32,423,424],{"__ignoreMap":92},[96,425,426,428,431],{"class":98,"line":99},[96,427,26],{"class":109},[96,429,430],{"class":116}," version",[96,432,433],{"class":112}," --client\n",[21,435,436],{},"Вывод должен показать версию клиента, например:",[87,438,443],{"className":439,"code":441,"language":442},[440],"language-text","Client Version: v1.28.4\n","text",[32,444,441],{"__ignoreMap":92},[21,446,447,448,451,452,455],{},"Если команда не найдена (",[32,449,450],{},"command not found","), проверьте, находится ли каталог установки в вашей ",[32,453,454],{},"PATH",":",[87,457,459],{"className":89,"code":458,"language":91,"meta":92,"style":92},"echo $PATH | grep -q '/usr/local/bin' || echo \"Добавьте /usr/local/bin в PATH\"\n",[32,460,461],{"__ignoreMap":92},[96,462,463,465,469,472,475,478,481,484,487],{"class":98,"line":99},[96,464,155],{"class":112},[96,466,468],{"class":467},"sVt8B"," $PATH ",[96,470,471],{"class":120},"|",[96,473,474],{"class":109}," grep",[96,476,477],{"class":112}," -q",[96,479,480],{"class":116}," '/usr/local/bin'",[96,482,483],{"class":120}," ||",[96,485,486],{"class":112}," echo",[96,488,489],{"class":116}," \"Добавьте /usr/local/bin в PATH\"\n",[21,491,492,495],{},[24,493,494],{},"Настройка автодополнения по Tab"," (существенно ускоряет работу):",[87,497,499],{"className":89,"code":498,"language":91,"meta":92,"style":92},"# Для bash\nsource \u003C(kubectl completion bash)\necho \"source \u003C(kubectl completion bash)\" >> ~/.bashrc\n\n# Для zsh\nsource \u003C(kubectl completion zsh)\necho \"source \u003C(kubectl completion zsh)\" >> ~/.zshrc\n",[32,500,501,506,519,532,536,541,552],{"__ignoreMap":92},[96,502,503],{"class":98,"line":99},[96,504,505],{"class":102},"# Для bash\n",[96,507,508,511,514,516],{"class":98,"line":106},[96,509,510],{"class":112},"source",[96,512,513],{"class":116}," \u003C(",[96,515,26],{"class":109},[96,517,518],{"class":116}," completion bash)\n",[96,520,521,523,526,529],{"class":98,"line":139},[96,522,155],{"class":112},[96,524,525],{"class":116}," \"source \u003C(kubectl completion bash)\"",[96,527,528],{"class":120}," >>",[96,530,531],{"class":116}," ~/.bashrc\n",[96,533,534],{"class":98,"line":146},[96,535,143],{"emptyLinePlaceholder":142},[96,537,538],{"class":98,"line":152},[96,539,540],{"class":102},"# Для zsh\n",[96,542,543,545,547,549],{"class":98,"line":171},[96,544,510],{"class":112},[96,546,513],{"class":116},[96,548,26],{"class":109},[96,550,551],{"class":116}," completion zsh)\n",[96,553,554,556,559,561],{"class":98,"line":176},[96,555,155],{"class":112},[96,557,558],{"class":116}," \"source \u003C(kubectl completion zsh)\"",[96,560,528],{"class":120},[96,562,563],{"class":116}," ~/.zshrc\n",[16,565,567],{"id":566},"шаг-4-настройка-подключения-к-кластеру-kubeconfig","Шаг 4: Настройка подключения к кластеру (kubeconfig)",[21,569,570,572,573,576],{},[32,571,26],{}," ищет конфигурацию кластера в файле ",[32,574,575],{},"~/.kube/config",". Получить его можно несколькими способами:",[43,578,579,589,622],{},[46,580,581,584,585,588],{},[24,582,583],{},"От администратора кластера:"," Вам передадут файл ",[32,586,587],{},"config"," или команду для его получения.",[46,590,591,594],{},[24,592,593],{},"Сервисы облачных провайдеров:",[595,596,597,606,614],"ul",{},[46,598,599,602,603],{},[24,600,601],{},"GKE (Google):"," ",[32,604,605],{},"gcloud container clusters get-credentials CLUSTER_NAME --zone ZONE --project PROJECT_ID",[46,607,608,602,611],{},[24,609,610],{},"EKS (AWS):",[32,612,613],{},"aws eks update-kubeconfig --name CLUSTER_NAME --region REGION",[46,615,616,602,619],{},[24,617,618],{},"AKS (Azure):",[32,620,621],{},"az aks get-credentials --resource-group RG_NAME --name CLUSTER_NAME",[46,623,624,602,627,630],{},[24,625,626],{},"Локальный кластер (Minikube):",[32,628,629],{},"minikube start"," автоматически настроит конфиг.",[21,632,633],{},"После настройки проверьте доступ:",[87,635,637],{"className":89,"code":636,"language":91,"meta":92,"style":92},"kubectl cluster-info\n",[32,638,639],{"__ignoreMap":92},[96,640,641,643],{"class":98,"line":99},[96,642,26],{"class":109},[96,644,645],{"class":116}," cluster-info\n",[21,647,648],{},"Если вы видите URL API-сервера — подключение установлено.",[16,650,652],{"id":651},"шаг-5-базовые-команды-для-проверки-работоспособности","Шаг 5: Базовые команды для проверки работоспособности",[21,654,655],{},"Выполните несколько простых команд, чтобы убедиться, что всё работает:",[87,657,659],{"className":89,"code":658,"language":91,"meta":92,"style":92},"# Показать информацию о кластере\nkubectl get nodes\n\n# Показать пространства имен (namespaces)\nkubectl get namespaces\n\n# Получить справку по любой команде\nkubectl get --help\n",[32,660,661,666,676,680,685,694,698,703],{"__ignoreMap":92},[96,662,663],{"class":98,"line":99},[96,664,665],{"class":102},"# Показать информацию о кластере\n",[96,667,668,670,673],{"class":98,"line":106},[96,669,26],{"class":109},[96,671,672],{"class":116}," get",[96,674,675],{"class":116}," nodes\n",[96,677,678],{"class":98,"line":139},[96,679,143],{"emptyLinePlaceholder":142},[96,681,682],{"class":98,"line":146},[96,683,684],{"class":102},"# Показать пространства имен (namespaces)\n",[96,686,687,689,691],{"class":98,"line":152},[96,688,26],{"class":109},[96,690,672],{"class":116},[96,692,693],{"class":116}," namespaces\n",[96,695,696],{"class":98,"line":171},[96,697,143],{"emptyLinePlaceholder":142},[96,699,700],{"class":98,"line":176},[96,701,702],{"class":102},"# Получить справку по любой команде\n",[96,704,705,707,709],{"class":98,"line":182},[96,706,26],{"class":109},[96,708,672],{"class":116},[96,710,711],{"class":112}," --help\n",[21,713,714,715,718,719,722],{},"Если ",[32,716,717],{},"kubectl get nodes"," выводит список нод вашего кластера (или для Minikube — одну ноду ",[32,720,721],{},"minikube","), установка и настройка завершены успешно.",[16,724,726],{"id":725},"проверка-результата","Проверка результата",[21,728,729],{},"Готовность подтверждается:",[43,731,732,739,745],{},[46,733,734,735,738],{},"Команда ",[32,736,737],{},"kubectl version --client"," возвращает версию без ошибок.",[46,740,734,741,744],{},[32,742,743],{},"kubectl cluster-info"," показывает данные о подключенном кластере (или ошибку аутентификации, если конфиг неверный, но сам клиент работает).",[46,746,747,748,751],{},"Автодополнение по ",[32,749,750],{},"Tab"," предлагает ресурсы и имена.",[16,753,755],{"id":754},"возможные-проблемы","Возможные проблемы",[82,757,759,760],{"id":758},"ошибка-the-connection-to-the-server-localhost8080-was-refused","Ошибка: ",[32,761,762],{},"The connection to the server localhost:8080 was refused",[21,764,765,768,769,771,772,775,776,778],{},[24,766,767],{},"Причина:"," Файл ",[32,770,575],{}," отсутствует или не содержит корректных данных о кластере.\n",[24,773,774],{},"Решение:"," Настройте ",[32,777,68],{}," согласно шагу 4. Убедитесь, что вы выполнили команду от облачного провайдера или получили файл конфигурации.",[82,780,759,782],{"id":781},"ошибка-error-you-must-be-logged-in-to-the-server-unauthorized",[32,783,784],{},"error: You must be logged in to the server (Unauthorized)",[21,786,787,789,790,792,793,796,797,796,800,69],{},[24,788,767],{}," В конфиге указаны неверные учетные данные (сертификат, токен, логин/пароль).\n",[24,791,774],{}," Пересоздайте конфигурацию, получив новые учетные данные от администратора кластера или через CLI облачного провайдера (",[32,794,795],{},"gcloud",", ",[32,798,799],{},"aws",[32,801,802],{},"az",[82,804,759,806,809],{"id":805},"ошибка-kubectl-command-not-found-после-установки",[32,807,808],{},"kubectl: command not found"," после установки",[21,811,812,814,815,817,818,820,821,823,824,826,827,314,830,833,834,52],{},[24,813,767],{}," Каталог, куда установлен бинарный файл (например, ",[32,816,405],{},"), не входит в переменную ",[32,819,454],{}," текущей сессии.\n",[24,822,774],{}," Добавьте путь в ",[32,825,454],{}," в ",[32,828,829],{},"~/.bashrc",[32,831,832],{},"~/.zshrc"," и перезапустите терминал. Либо создайте симлинк: ",[32,835,836],{},"sudo ln -s /usr/local/bin/kubectl /usr/bin/kubectl",[82,838,840,841],{"id":839},"ошибка-при-установке-пакета-unable-to-read-etcaptsourceslistd","Ошибка при установке пакета: ",[32,842,843],{},"Unable to read /etc/apt/sources.list.d/...",[21,845,846,848,849,851,852,854],{},[24,847,767],{}," Неправильно создан файл репозитория или отсутствует GPG-ключ.\n",[24,850,774],{}," Проверьте шаг 1. Убедитесь, что вы использовали ",[32,853,51],{}," для записи в системные каталоги. Пересоздайте файл репозитория и ключ.",[82,856,858],{"id":857},"версия-kubectl-несовместима-с-кластером","Версия kubectl несовместима с кластером",[21,860,861,863,864,866,867,869,870,873,874,876],{},[24,862,767],{}," Разница версий больше одной минорной.\n",[24,865,774],{}," Установите другую версию ",[32,868,26],{},", указав нужный тег репозитория (например, ",[32,871,872],{},"v1.27"," вместо ",[32,875,203],{},"). Либо обновите/понизьте версию самого кластера.",[87,878,880],{"className":89,"code":879,"language":91,"meta":92,"style":92},"# Пример установки конкретной версии на Ubuntu\nsudo apt-get install kubectl=1.27.5-00\n",[32,881,882,887],{"__ignoreMap":92},[96,883,884],{"class":98,"line":99},[96,885,886],{"class":102},"# Пример установки конкретной версии на Ubuntu\n",[96,888,889,891,893,895],{"class":98,"line":106},[96,890,51],{"class":109},[96,892,187],{"class":116},[96,894,342],{"class":116},[96,896,897],{"class":116}," kubectl=1.27.5-00\n",[87,899,901],{"className":89,"code":900,"language":91,"meta":92,"style":92},"# Пример на CentOS/RHEL\nsudo yum install kubectl-1.27.5\n",[32,902,903,908],{"__ignoreMap":92},[96,904,905],{"class":98,"line":99},[96,906,907],{"class":102},"# Пример на CentOS/RHEL\n",[96,909,910,912,914,916],{"class":98,"line":106},[96,911,51],{"class":109},[96,913,298],{"class":116},[96,915,342],{"class":116},[96,917,918],{"class":116}," kubectl-1.27.5\n",[920,921,922],"style",{},"html pre.shiki code .sJ8bj, html code.shiki .sJ8bj{--shiki-default:#6A737D;--shiki-dark:#6A737D}html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .szBVR, html code.shiki .szBVR{--shiki-default:#D73A49;--shiki-dark:#F97583}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}",{"title":92,"searchDepth":106,"depth":106,"links":924},[925,926,927,931,935,936,937,938,939],{"id":18,"depth":106,"text":19},{"id":37,"depth":106,"text":38},{"id":72,"depth":106,"text":73,"children":928},[929,930],{"id":84,"depth":139,"text":85},{"id":218,"depth":139,"text":219},{"id":320,"depth":106,"text":321,"children":932},[933,934],{"id":327,"depth":139,"text":328},{"id":351,"depth":139,"text":352},{"id":414,"depth":106,"text":415},{"id":566,"depth":106,"text":567},{"id":651,"depth":106,"text":652},{"id":725,"depth":106,"text":726},{"id":754,"depth":106,"text":755,"children":940},[941,943,945,947,949],{"id":758,"depth":139,"text":942},"Ошибка: The connection to the server localhost:8080 was refused",{"id":781,"depth":139,"text":944},"Ошибка: error: You must be logged in to the server (Unauthorized)",{"id":805,"depth":139,"text":946},"Ошибка: kubectl: command not found после установки",{"id":839,"depth":139,"text":948},"Ошибка при установке пакета: Unable to read /etc/apt/sources.list.d/...",{"id":857,"depth":139,"text":858},null,"2026-02-14 23:28:18","Пошаговая инструкция по установке и настройке CLI-инструмента kubectl на Ubuntu, CentOS и других дистрибутивах Linux. Начните работать с Kubernetes уже сегодня.","easy",false,"10-15 мин","md",[958,961,964,967],{"question":959,"answer":960},"Можно ли установить kubectl без прав sudo?","Теоретически можно, собрав из исходников или установив в домашнюю директорию, но стандартный пакетный менеджер требует sudo. Рекомендуется использовать права администратора для системного инструмента.",{"question":962,"answer":963},"Какая версия kubectl совместима с моим кластером Kubernetes?","Правило: версия kubectl должна отличаться не более чем на одну минорную версию от версии `kube-apiserver` вашего кластера. Например, для кластера 1.28 подойдет kubectl 1.27, 1.28 или 1.29.",{"question":965,"answer":966},"Нужно ли устанавливать Docker вместе с kubectl?","Нет. kubectl — это только клиент для управления кластером. Docker (или containerd) требуется на узлах кластера (worker-нодах), но не на машине, где работает только kubectl для администрирования.",{"question":968,"answer":969},"Почему после установки команда `kubectl` не найдена?","Чаще всего это связано с тем, что каталог `/usr/local/bin` (куда ставится kubectl) не находится в переменной окружения PATH. Проверьте `echo $PATH` и добавьте путь при необходимости.",[971,974,977,980],{"name":972,"text":973},"Добавление официального репозитория Kubernetes","Импортируйте GPG-ключ и добавьте репозиторий, чтобы получать актуальные и безопасные версии пакета.",{"name":975,"text":976},"Установка пакета kubectl","Используйте менеджер пакетов вашего дистрибутива (apt, yum) для установки бинарного файла.",{"name":978,"text":979},"Проверка установки","Запустите команду `kubectl version --client`, чтобы убедиться, что клиент установлен и доступен.",{"name":981,"text":982},"Настройка конфигурации (kubeconfig)","Скопируйте файл конфигурации доступа к вашему кластеру в `~/.kube/config` или используйте `kubectl config set-credentials`.","PT10M",[985,986,987,988,989,990,991,992],"установка kubectl linux","kubectl скачать и установить","как установить kubectl на ubuntu","k8s cli установка linux","kubectl команды для начинающих","ошибка kubectl command not found","установка kubernetes cli","kubectl centos install","ru_RU",{},"/guides/linux/setup-kubectl","linux",[998,999,1000],"/guides/linux/setup-minikube","/guides/linux/install-docker-ce","/errors/linux/kubectl-command-not-found","Гайды Kubernetes",{"title":5,"description":952},"guides/linux/setup-kubectl","Это руководство поможет вам установить официальный CLI-инструмент kubectl на Linux. Вы научитесь добавлять официальный репозиторий, устанавливать пакет и проверять работоспособность, чтобы управлять кластерами Kubernetes.",[26,1006,1007,1008,1009,1010,1011],"Kubernetes","Linux","установка","CLI","k8s","гейд","guide","yH6K-fJCoUtFA525w6sT9gjj_uCdZKTT4YE-o_2uF4E",{"data":1015,"body":1016},{},{"type":1017,"children":1018},"root",[1019],{"type":1020,"tag":21,"props":1021,"children":1022},"element",{},[1023],{"type":442,"value":960},{"data":1025,"body":1026},{},{"type":1017,"children":1027},[1028],{"type":1020,"tag":21,"props":1029,"children":1030},{},[1031,1033,1039],{"type":442,"value":1032},"Правило: версия kubectl должна отличаться не более чем на одну минорную версию от версии ",{"type":1020,"tag":32,"props":1034,"children":1036},{"className":1035},[],[1037],{"type":442,"value":1038},"kube-apiserver",{"type":442,"value":1040}," вашего кластера. Например, для кластера 1.28 подойдет kubectl 1.27, 1.28 или 1.29.",{"data":1042,"body":1043},{},{"type":1017,"children":1044},[1045],{"type":1020,"tag":21,"props":1046,"children":1047},{},[1048],{"type":442,"value":966},{"data":1050,"body":1051},{},{"type":1017,"children":1052},[1053],{"type":1020,"tag":21,"props":1054,"children":1055},{},[1056,1058,1063,1065,1071],{"type":442,"value":1057},"Чаще всего это связано с тем, что каталог ",{"type":1020,"tag":32,"props":1059,"children":1061},{"className":1060},[],[1062],{"type":442,"value":405},{"type":442,"value":1064}," (куда ставится kubectl) не находится в переменной окружения PATH. Проверьте ",{"type":1020,"tag":32,"props":1066,"children":1068},{"className":1067},[],[1069],{"type":442,"value":1070},"echo $PATH",{"type":442,"value":1072}," и добавьте путь при необходимости.",{"data":1074,"body":1075},{},{"type":1017,"children":1076},[1077],{"type":1020,"tag":21,"props":1078,"children":1079},{},[1080],{"type":442,"value":973},{"data":1082,"body":1083},{},{"type":1017,"children":1084},[1085],{"type":1020,"tag":21,"props":1086,"children":1087},{},[1088],{"type":442,"value":976},{"data":1090,"body":1091},{},{"type":1017,"children":1092},[1093],{"type":1020,"tag":21,"props":1094,"children":1095},{},[1096,1098,1103],{"type":442,"value":1097},"Запустите команду ",{"type":1020,"tag":32,"props":1099,"children":1101},{"className":1100},[],[1102],{"type":442,"value":737},{"type":442,"value":1104},", чтобы убедиться, что клиент установлен и доступен.",{"data":1106,"body":1107},{},{"type":1017,"children":1108},[1109],{"type":1020,"tag":21,"props":1110,"children":1111},{},[1112,1114,1119,1121,1127],{"type":442,"value":1113},"Скопируйте файл конфигурации доступа к вашему кластеру в ",{"type":1020,"tag":32,"props":1115,"children":1117},{"className":1116},[],[1118],{"type":442,"value":575},{"type":442,"value":1120}," или используйте ",{"type":1020,"tag":32,"props":1122,"children":1124},{"className":1123},[],[1125],{"type":442,"value":1126},"kubectl config set-credentials",{"type":442,"value":52},[1129,2319,3087],{"id":1130,"title":1131,"appliesTo":1132,"author":11,"body":1137,"canonical":950,"code":950,"createdAt":2263,"description":2264,"difficulty":2265,"draft":954,"estimatedTime":2266,"extension":956,"faq":2267,"howToSteps":2280,"howToTotalTime":2296,"image":950,"keywords":2297,"locale":993,"meta":2306,"navigation":142,"path":998,"platform":996,"related":2307,"section":1001,"seo":2310,"severity":950,"stem":2311,"summary":2312,"tags":2313,"twitterCreator":950,"twitterSite":950,"type":1012,"updatedAt":2263,"__hash__":2318},"content_ru/guides/linux/setup-minikube.md","Установка Minikube на Ubuntu/Debian: полное руководство",[1133,1134,1135,1136],"Ubuntu 22.04+","Debian 11+","Minikube v1.30+","Docker 20.10+",{"type":13,"value":1138,"toc":2241},[1139,1141,1144,1155,1160,1162,1165,1218,1220,1224,1228,1231,1561,1568,1572,1575,1654,1658,1664,1723,1734,1740,1744,1749,1911,1915,2016,2018,2025,2057,2059,2069,2074,2112,2120,2128,2192,2202,2215,2222,2238],[16,1140,19],{"id":18},[21,1142,1143],{},"Minikube — это инструмент, который запускает однокластерный Kubernetes на вашей локальной машине. Это идеальное решение для разработчиков и DevOps-инженеров, которые хотят:",[595,1145,1146,1149,1152],{},[46,1147,1148],{},"Обучиться основам Kubernetes без доступа к облачному кластеру.",[46,1150,1151],{},"Разрабатывать и тестировать манифесты (Deployment, Service, и т.д.) локально.",[46,1153,1154],{},"Пробовать новые версии Kubernetes или его компонентов.",[21,1156,1157,1158,52],{},"После выполнения этого гайда у вас будет полностью рабочий кластер Kubernetes, управляемый через стандартный CLI-инструмент ",[32,1159,26],{},[16,1161,38],{"id":37},[21,1163,1164],{},"Перед началом убедитесь, что ваша система соответствует следующим требованиям:",[43,1166,1167,1173,1182,1208],{},[46,1168,1169,1172],{},[24,1170,1171],{},"ОС",": Ubuntu 22.04+, Debian 11+ или любая другая современная дистрибутив на базе systemd.",[46,1174,1175,1178,1179,1181],{},[24,1176,1177],{},"Права",": Доступ к ",[32,1180,51],{}," для установки пакетов и управления службами.",[46,1183,1184,1187,1188],{},[24,1185,1186],{},"Ресурсы",":\n",[595,1189,1190,1196,1202],{},[46,1191,1192,1195],{},[24,1193,1194],{},"RAM",": минимум 2 ГБ, рекомендуется 4 ГБ.",[46,1197,1198,1201],{},[24,1199,1200],{},"CPU",": минимум 2 ядра.",[46,1203,1204,1207],{},[24,1205,1206],{},"Дисковое пространство",": минимум 20 ГБ свободного места.",[46,1209,1210,1213,1214,1217],{},[24,1211,1212],{},"Драйвер виртуализации",": Мы будем использовать ",[24,1215,1216],{},"Docker"," как драйвер, так как это самый простой путь на Linux. У вас должен быть установлен и запущен Docker.",[410,1219],{},[16,1221,1223],{"id":1222},"пошаговая-инструкция","Пошаговая инструкция",[82,1225,1227],{"id":1226},"шаг-1-установка-и-запуск-docker","Шаг 1: Установка и запуск Docker",[21,1229,1230],{},"Minikube требует наличия работающего контейнерного рантайма. Docker — наиболее стойкий выбор.",[87,1232,1234],{"className":89,"code":1233,"language":91,"meta":92,"style":92},"# Обновляем кэш пакетов\nsudo apt-get update\n\n# Устанавливаем необходимые пакеты для работы с HTTPS-репозиториями\nsudo apt-get install -y ca-certificates curl gnupg\n\n# Добавляем официальный GPG-ключ Docker\nsudo install -m 0755 -d /etc/apt/keyrings\ncurl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg\nsudo chmod a+r /etc/apt/keyrings/docker.gpg\n\n# Добавляем репозиторий Docker (для Ubuntu, для Debian замените на соответствующий)\necho \\\n  \"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \\\n  $(. /etc/os-release && echo \"$VERSION_CODENAME\") stable\" | \\\n  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null\n\n# Устанавливаем Docker Engine и компоненты\nsudo apt-get update\nsudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin\n\n# Добавляем текущего пользователя в группу docker (чтобы не использовать sudo)\nsudo usermod -aG docker $USER\nnewgrp docker  # Применяем изменения группы без перезахода в систему\n\n# Запускаем и включаем автозагрузку службы Docker\nsudo systemctl start docker\nsudo systemctl enable docker\n\n# Проверяем, что Docker работает\ndocker run hello-world\n",[32,1235,1236,1241,1249,1253,1258,1277,1281,1286,1304,1326,1338,1342,1347,1355,1373,1399,1416,1421,1427,1436,1462,1467,1473,1490,1501,1506,1512,1526,1538,1543,1549],{"__ignoreMap":92},[96,1237,1238],{"class":98,"line":99},[96,1239,1240],{"class":102},"# Обновляем кэш пакетов\n",[96,1242,1243,1245,1247],{"class":98,"line":106},[96,1244,51],{"class":109},[96,1246,187],{"class":116},[96,1248,190],{"class":116},[96,1250,1251],{"class":98,"line":139},[96,1252,143],{"emptyLinePlaceholder":142},[96,1254,1255],{"class":98,"line":146},[96,1256,1257],{"class":102},"# Устанавливаем необходимые пакеты для работы с HTTPS-репозиториями\n",[96,1259,1260,1262,1264,1266,1268,1271,1274],{"class":98,"line":152},[96,1261,51],{"class":109},[96,1263,187],{"class":116},[96,1265,342],{"class":116},[96,1267,345],{"class":112},[96,1269,1270],{"class":116}," ca-certificates",[96,1272,1273],{"class":116}," curl",[96,1275,1276],{"class":116}," gnupg\n",[96,1278,1279],{"class":98,"line":171},[96,1280,143],{"emptyLinePlaceholder":142},[96,1282,1283],{"class":98,"line":176},[96,1284,1285],{"class":102},"# Добавляем официальный GPG-ключ Docker\n",[96,1287,1288,1290,1292,1295,1298,1301],{"class":98,"line":182},[96,1289,51],{"class":109},[96,1291,342],{"class":116},[96,1293,1294],{"class":112}," -m",[96,1296,1297],{"class":112}," 0755",[96,1299,1300],{"class":112}," -d",[96,1302,1303],{"class":116}," /etc/apt/keyrings\n",[96,1305,1306,1308,1310,1313,1315,1317,1319,1321,1323],{"class":98,"line":277},[96,1307,58],{"class":109},[96,1309,113],{"class":112},[96,1311,1312],{"class":116}," https://download.docker.com/linux/ubuntu/gpg",[96,1314,121],{"class":120},[96,1316,124],{"class":109},[96,1318,127],{"class":116},[96,1320,130],{"class":112},[96,1322,133],{"class":112},[96,1324,1325],{"class":116}," /etc/apt/keyrings/docker.gpg\n",[96,1327,1328,1330,1333,1336],{"class":98,"line":282},[96,1329,51],{"class":109},[96,1331,1332],{"class":116}," chmod",[96,1334,1335],{"class":116}," a+r",[96,1337,1325],{"class":116},[96,1339,1340],{"class":98,"line":287},[96,1341,143],{"emptyLinePlaceholder":142},[96,1343,1344],{"class":98,"line":293},[96,1345,1346],{"class":102},"# Добавляем репозиторий Docker (для Ubuntu, для Debian замените на соответствующий)\n",[96,1348,1350,1352],{"class":98,"line":1349},13,[96,1351,155],{"class":112},[96,1353,1354],{"class":112}," \\\n",[96,1356,1358,1361,1364,1367,1370],{"class":98,"line":1357},14,[96,1359,1360],{"class":116},"  \"deb [arch=$(",[96,1362,1363],{"class":109},"dpkg",[96,1365,1366],{"class":112}," --print-architecture",[96,1368,1369],{"class":116},") signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu ",[96,1371,1372],{"class":112},"\\\n",[96,1374,1376,1379,1381,1384,1386,1389,1392,1395,1397],{"class":98,"line":1375},15,[96,1377,1378],{"class":116},"  $(",[96,1380,52],{"class":112},[96,1382,1383],{"class":116}," /etc/os-release && ",[96,1385,155],{"class":112},[96,1387,1388],{"class":116}," \"",[96,1390,1391],{"class":467},"$VERSION_CODENAME",[96,1393,1394],{"class":116},"\") stable\"",[96,1396,121],{"class":120},[96,1398,1354],{"class":112},[96,1400,1402,1405,1407,1410,1413],{"class":98,"line":1401},16,[96,1403,1404],{"class":109},"  sudo",[96,1406,165],{"class":116},[96,1408,1409],{"class":116}," /etc/apt/sources.list.d/docker.list",[96,1411,1412],{"class":120}," >",[96,1414,1415],{"class":116}," /dev/null\n",[96,1417,1419],{"class":98,"line":1418},17,[96,1420,143],{"emptyLinePlaceholder":142},[96,1422,1424],{"class":98,"line":1423},18,[96,1425,1426],{"class":102},"# Устанавливаем Docker Engine и компоненты\n",[96,1428,1430,1432,1434],{"class":98,"line":1429},19,[96,1431,51],{"class":109},[96,1433,187],{"class":116},[96,1435,190],{"class":116},[96,1437,1439,1441,1443,1445,1447,1450,1453,1456,1459],{"class":98,"line":1438},20,[96,1440,51],{"class":109},[96,1442,187],{"class":116},[96,1444,342],{"class":116},[96,1446,345],{"class":112},[96,1448,1449],{"class":116}," docker-ce",[96,1451,1452],{"class":116}," docker-ce-cli",[96,1454,1455],{"class":116}," containerd.io",[96,1457,1458],{"class":116}," docker-buildx-plugin",[96,1460,1461],{"class":116}," docker-compose-plugin\n",[96,1463,1465],{"class":98,"line":1464},21,[96,1466,143],{"emptyLinePlaceholder":142},[96,1468,1470],{"class":98,"line":1469},22,[96,1471,1472],{"class":102},"# Добавляем текущего пользователя в группу docker (чтобы не использовать sudo)\n",[96,1474,1476,1478,1481,1484,1487],{"class":98,"line":1475},23,[96,1477,51],{"class":109},[96,1479,1480],{"class":116}," usermod",[96,1482,1483],{"class":112}," -aG",[96,1485,1486],{"class":116}," docker",[96,1488,1489],{"class":467}," $USER\n",[96,1491,1493,1496,1498],{"class":98,"line":1492},24,[96,1494,1495],{"class":109},"newgrp",[96,1497,1486],{"class":116},[96,1499,1500],{"class":102},"  # Применяем изменения группы без перезахода в систему\n",[96,1502,1504],{"class":98,"line":1503},25,[96,1505,143],{"emptyLinePlaceholder":142},[96,1507,1509],{"class":98,"line":1508},26,[96,1510,1511],{"class":102},"# Запускаем и включаем автозагрузку службы Docker\n",[96,1513,1515,1517,1520,1523],{"class":98,"line":1514},27,[96,1516,51],{"class":109},[96,1518,1519],{"class":116}," systemctl",[96,1521,1522],{"class":116}," start",[96,1524,1525],{"class":116}," docker\n",[96,1527,1529,1531,1533,1536],{"class":98,"line":1528},28,[96,1530,51],{"class":109},[96,1532,1519],{"class":116},[96,1534,1535],{"class":116}," enable",[96,1537,1525],{"class":116},[96,1539,1541],{"class":98,"line":1540},29,[96,1542,143],{"emptyLinePlaceholder":142},[96,1544,1546],{"class":98,"line":1545},30,[96,1547,1548],{"class":102},"# Проверяем, что Docker работает\n",[96,1550,1552,1555,1558],{"class":98,"line":1551},31,[96,1553,1554],{"class":109},"docker",[96,1556,1557],{"class":116}," run",[96,1559,1560],{"class":116}," hello-world\n",[21,1562,1563,1564,1567],{},"Если команда ",[32,1565,1566],{},"docker run hello-world"," завершилась с выводом \"Hello from Docker!\", драйвер готов.",[82,1569,1571],{"id":1570},"шаг-2-установка-minikube","Шаг 2: Установка Minikube",[21,1573,1574],{},"Скачаем последнюю стабильную версию Minikube с официального репозитория GitHub.",[87,1576,1578],{"className":89,"code":1577,"language":91,"meta":92,"style":92},"# Определяем последнюю версию (на момент написания — v1.33.1)\nMINIKUBE_VERSION=\"v1.33.1\"\n# Скачиваем бинарный файл\ncurl -LO https://storage.googleapis.com/minikube/releases/${MINIKUBE_VERSION}/minikube-linux-amd64\n\n# Устанавливаем в /usr/local/bin\nsudo install minikube-linux-amd64 /usr/local/bin/minikube\n\n# Проверяем установку\nminikube version\n",[32,1579,1580,1585,1596,1601,1617,1621,1626,1638,1642,1647],{"__ignoreMap":92},[96,1581,1582],{"class":98,"line":99},[96,1583,1584],{"class":102},"# Определяем последнюю версию (на момент написания — v1.33.1)\n",[96,1586,1587,1590,1593],{"class":98,"line":106},[96,1588,1589],{"class":467},"MINIKUBE_VERSION",[96,1591,1592],{"class":120},"=",[96,1594,1595],{"class":116},"\"v1.33.1\"\n",[96,1597,1598],{"class":98,"line":139},[96,1599,1600],{"class":102},"# Скачиваем бинарный файл\n",[96,1602,1603,1605,1608,1611,1614],{"class":98,"line":146},[96,1604,58],{"class":109},[96,1606,1607],{"class":112}," -LO",[96,1609,1610],{"class":116}," https://storage.googleapis.com/minikube/releases/",[96,1612,1613],{"class":467},"${MINIKUBE_VERSION}",[96,1615,1616],{"class":116},"/minikube-linux-amd64\n",[96,1618,1619],{"class":98,"line":152},[96,1620,143],{"emptyLinePlaceholder":142},[96,1622,1623],{"class":98,"line":171},[96,1624,1625],{"class":102},"# Устанавливаем в /usr/local/bin\n",[96,1627,1628,1630,1632,1635],{"class":98,"line":176},[96,1629,51],{"class":109},[96,1631,342],{"class":116},[96,1633,1634],{"class":116}," minikube-linux-amd64",[96,1636,1637],{"class":116}," /usr/local/bin/minikube\n",[96,1639,1640],{"class":98,"line":182},[96,1641,143],{"emptyLinePlaceholder":142},[96,1643,1644],{"class":98,"line":277},[96,1645,1646],{"class":102},"# Проверяем установку\n",[96,1648,1649,1651],{"class":98,"line":282},[96,1650,721],{"class":109},[96,1652,1653],{"class":116}," version\n",[82,1655,1657],{"id":1656},"шаг-3-запуск-кластера-minikube","Шаг 3: Запуск кластера Minikube",[21,1659,1660,1661,1663],{},"Теперь можно создать и запустить кластер. Мы явно укажем драйвер ",[32,1662,1554],{}," и выделим 4 ГБ оперативной памяти.",[87,1665,1667],{"className":89,"code":1666,"language":91,"meta":92,"style":92},"# Останавливаем предыдущий кластер, если он есть (необязательно)\nminikube stop\n\n# Запускаем новый кластер с параметрами:\n# --driver=docker: использовать Docker как драйвер виртуализации\n# --memory='4g': выделить 4 ГБ RAM\n# --cpus=2: выделить 2 CPU ядра\nminikube start --driver=docker --memory='4g' --cpus=2\n",[32,1668,1669,1674,1681,1685,1690,1695,1700,1705],{"__ignoreMap":92},[96,1670,1671],{"class":98,"line":99},[96,1672,1673],{"class":102},"# Останавливаем предыдущий кластер, если он есть (необязательно)\n",[96,1675,1676,1678],{"class":98,"line":106},[96,1677,721],{"class":109},[96,1679,1680],{"class":116}," stop\n",[96,1682,1683],{"class":98,"line":139},[96,1684,143],{"emptyLinePlaceholder":142},[96,1686,1687],{"class":98,"line":146},[96,1688,1689],{"class":102},"# Запускаем новый кластер с параметрами:\n",[96,1691,1692],{"class":98,"line":152},[96,1693,1694],{"class":102},"# --driver=docker: использовать Docker как драйвер виртуализации\n",[96,1696,1697],{"class":98,"line":171},[96,1698,1699],{"class":102},"# --memory='4g': выделить 4 ГБ RAM\n",[96,1701,1702],{"class":98,"line":176},[96,1703,1704],{"class":102},"# --cpus=2: выделить 2 CPU ядра\n",[96,1706,1707,1709,1711,1714,1717,1720],{"class":98,"line":182},[96,1708,721],{"class":109},[96,1710,1522],{"class":116},[96,1712,1713],{"class":112}," --driver=docker",[96,1715,1716],{"class":112}," --memory=",[96,1718,1719],{"class":116},"'4g'",[96,1721,1722],{"class":112}," --cpus=2\n",[192,1724,1725],{},[21,1726,306,1727,1729,1730,1733],{},[24,1728,309],{}," Первый запуск может занять 5-10 минут, так как Minikube будет скачивать образ Kubernetes (",[32,1731,1732],{},"k8s.gcr.io/kube-apiserver"," и др.) размером несколько сотен мегабайт.",[21,1735,1736,1737,52],{},"После успешного завершения вы увидите сообщение ",[32,1738,1739],{},"Done! kubectl is now configured to use \"minikube\" cluster...",[82,1741,1743],{"id":1742},"шаг-4-проверка-работоспособности-и-настройка-kubectl","Шаг 4: Проверка работоспособности и настройка kubectl",[21,1745,1746,1747,52],{},"Убедимся, что кластер запущен и доступен через ",[32,1748,26],{},[87,1750,1752],{"className":89,"code":1751,"language":91,"meta":92,"style":92},"# Показать статус кластера\nminikube status\n\n# Должен быть вывод, где все компоненты в состоянии Running.\n# Пример:\n# host: Running\n# kubelet: Running\n# apiserver: Running\n# kubeconfig: Configured\n\n# Проверим доступность кластера через kubectl\nkubectl cluster-info\n\n# Получим список нод (в Minikube она всегда одна)\nkubectl get nodes\n\n# Пробный деплой: создадим nginx-под\nkubectl create deployment nginx --image=nginx\nkubectl expose deployment nginx --type=NodePort --port=80\n\n# Проверим, что под работает\nkubectl get pods,svc\n\n# Получим URL для доступа к nginx в браузере\nminikube service nginx\n",[32,1753,1754,1759,1766,1770,1775,1780,1785,1790,1795,1800,1804,1809,1815,1819,1824,1832,1836,1841,1857,1874,1878,1883,1892,1896,1901],{"__ignoreMap":92},[96,1755,1756],{"class":98,"line":99},[96,1757,1758],{"class":102},"# Показать статус кластера\n",[96,1760,1761,1763],{"class":98,"line":106},[96,1762,721],{"class":109},[96,1764,1765],{"class":116}," status\n",[96,1767,1768],{"class":98,"line":139},[96,1769,143],{"emptyLinePlaceholder":142},[96,1771,1772],{"class":98,"line":146},[96,1773,1774],{"class":102},"# Должен быть вывод, где все компоненты в состоянии Running.\n",[96,1776,1777],{"class":98,"line":152},[96,1778,1779],{"class":102},"# Пример:\n",[96,1781,1782],{"class":98,"line":171},[96,1783,1784],{"class":102},"# host: Running\n",[96,1786,1787],{"class":98,"line":176},[96,1788,1789],{"class":102},"# kubelet: Running\n",[96,1791,1792],{"class":98,"line":182},[96,1793,1794],{"class":102},"# apiserver: Running\n",[96,1796,1797],{"class":98,"line":277},[96,1798,1799],{"class":102},"# kubeconfig: Configured\n",[96,1801,1802],{"class":98,"line":282},[96,1803,143],{"emptyLinePlaceholder":142},[96,1805,1806],{"class":98,"line":287},[96,1807,1808],{"class":102},"# Проверим доступность кластера через kubectl\n",[96,1810,1811,1813],{"class":98,"line":293},[96,1812,26],{"class":109},[96,1814,645],{"class":116},[96,1816,1817],{"class":98,"line":1349},[96,1818,143],{"emptyLinePlaceholder":142},[96,1820,1821],{"class":98,"line":1357},[96,1822,1823],{"class":102},"# Получим список нод (в Minikube она всегда одна)\n",[96,1825,1826,1828,1830],{"class":98,"line":1375},[96,1827,26],{"class":109},[96,1829,672],{"class":116},[96,1831,675],{"class":116},[96,1833,1834],{"class":98,"line":1401},[96,1835,143],{"emptyLinePlaceholder":142},[96,1837,1838],{"class":98,"line":1418},[96,1839,1840],{"class":102},"# Пробный деплой: создадим nginx-под\n",[96,1842,1843,1845,1848,1851,1854],{"class":98,"line":1423},[96,1844,26],{"class":109},[96,1846,1847],{"class":116}," create",[96,1849,1850],{"class":116}," deployment",[96,1852,1853],{"class":116}," nginx",[96,1855,1856],{"class":112}," --image=nginx\n",[96,1858,1859,1861,1864,1866,1868,1871],{"class":98,"line":1429},[96,1860,26],{"class":109},[96,1862,1863],{"class":116}," expose",[96,1865,1850],{"class":116},[96,1867,1853],{"class":116},[96,1869,1870],{"class":112}," --type=NodePort",[96,1872,1873],{"class":112}," --port=80\n",[96,1875,1876],{"class":98,"line":1438},[96,1877,143],{"emptyLinePlaceholder":142},[96,1879,1880],{"class":98,"line":1464},[96,1881,1882],{"class":102},"# Проверим, что под работает\n",[96,1884,1885,1887,1889],{"class":98,"line":1469},[96,1886,26],{"class":109},[96,1888,672],{"class":116},[96,1890,1891],{"class":116}," pods,svc\n",[96,1893,1894],{"class":98,"line":1475},[96,1895,143],{"emptyLinePlaceholder":142},[96,1897,1898],{"class":98,"line":1492},[96,1899,1900],{"class":102},"# Получим URL для доступа к nginx в браузере\n",[96,1902,1903,1905,1908],{"class":98,"line":1503},[96,1904,721],{"class":109},[96,1906,1907],{"class":116}," service",[96,1909,1910],{"class":116}," nginx\n",[82,1912,1914],{"id":1913},"шаг-5-полезные-команды-и-настройка","Шаг 5: Полезные команды и настройка",[595,1916,1917,1934,1952,1970,2000],{},[46,1918,1919,1922,1923],{},[24,1920,1921],{},"Остановка кластера"," (сохраняет состояние):\n",[87,1924,1926],{"className":89,"code":1925,"language":91,"meta":92,"style":92},"minikube stop\n",[32,1927,1928],{"__ignoreMap":92},[96,1929,1930,1932],{"class":98,"line":99},[96,1931,721],{"class":109},[96,1933,1680],{"class":116},[46,1935,1936,1939,1940],{},[24,1937,1938],{},"Удаление кластера"," (полная очистка):\n",[87,1941,1943],{"className":89,"code":1942,"language":91,"meta":92,"style":92},"minikube delete\n",[32,1944,1945],{"__ignoreMap":92},[96,1946,1947,1949],{"class":98,"line":99},[96,1948,721],{"class":109},[96,1950,1951],{"class":116}," delete\n",[46,1953,1954,1957,1958],{},[24,1955,1956],{},"Доступ к консоли ноды"," (как к виртуальной машине):\n",[87,1959,1961],{"className":89,"code":1960,"language":91,"meta":92,"style":92},"minikube ssh\n",[32,1962,1963],{"__ignoreMap":92},[96,1964,1965,1967],{"class":98,"line":99},[96,1966,721],{"class":109},[96,1968,1969],{"class":116}," ssh\n",[46,1971,1972,1975,1976,1979,1980],{},[24,1973,1974],{},"Установка драйвера по умолчанию"," (чтобы не указывать ",[32,1977,1978],{},"--driver"," каждый раз):\n",[87,1981,1983],{"className":89,"code":1982,"language":91,"meta":92,"style":92},"minikube config set driver docker\n",[32,1984,1985],{"__ignoreMap":92},[96,1986,1987,1989,1992,1995,1998],{"class":98,"line":99},[96,1988,721],{"class":109},[96,1990,1991],{"class":116}," config",[96,1993,1994],{"class":116}," set",[96,1996,1997],{"class":116}," driver",[96,1999,1525],{"class":116},[46,2001,2002,1187,2005],{},[24,2003,2004],{},"Обновление Minikube",[87,2006,2008],{"className":89,"code":2007,"language":91,"meta":92,"style":92},"minikube update\n",[32,2009,2010],{"__ignoreMap":92},[96,2011,2012,2014],{"class":98,"line":99},[96,2013,721],{"class":109},[96,2015,190],{"class":116},[16,2017,726],{"id":725},[21,2019,2020,2021,2024],{},"Выполните следующие команды. Если все они возвращают успешный результат (",[32,2022,2023],{},"Running",", список объектов), установка прошла корректно:",[43,2026,2027,2035,2043,2051],{},[46,2028,2029,2032,2033,52],{},[32,2030,2031],{},"minikube status"," — все компоненты ",[32,2034,2023],{},[46,2036,2037,2039,2040,52],{},[32,2038,717],{}," — нода в статусе ",[32,2041,2042],{},"Ready",[46,2044,2045,2048,2049,52],{},[32,2046,2047],{},"kubectl get pods -A"," — системные поды (coredns, etcd, kube-apiserver и др.) в статусе ",[32,2050,2023],{},[46,2052,2053,2056],{},[32,2054,2055],{},"minikube service list"," — сервисы, созданные вами, отображаются.",[16,2058,755],{"id":754},[82,2060,2062,2063,2065,2066],{"id":2061},"проблема-minikube-start-завершается-с-ошибкой-failed-to-start-host","Проблема: ",[32,2064,629],{}," завершается с ошибкой ",[32,2067,2068],{},"Failed to start host: ...",[21,2070,2071],{},[24,2072,2073],{},"Причина и решение:",[595,2075,2076,2093,2102],{},[46,2077,2078,2081,2082,2085,2086,2089,2090,52],{},[24,2079,2080],{},"Недостаточно памяти/CPU",". Увеличьте параметры ",[32,2083,2084],{},"--memory"," и ",[32,2087,2088],{},"--cpus",". Например, ",[32,2091,2092],{},"--memory=6g --cpus=3",[46,2094,2095,2098,2099,69],{},[24,2096,2097],{},"Порт 8443 занят"," (используется другим процессом или другим Minikube-кластером). Остановите конфликтующий процесс или удалите старый кластер (",[32,2100,2101],{},"minikube delete",[46,2103,2104,2107,2108,2111],{},[24,2105,2106],{},"Docker не работает",". Проверьте ",[32,2109,2110],{},"systemctl status docker",". Если служба не активна, запустите её.",[82,2113,2062,2115,2117,2118],{"id":2114},"проблема-kubectl-не-найден-или-kubectl-command-not-found",[32,2116,26],{}," не найден или ",[32,2119,808],{},[21,2121,2122,2124,2125,2127],{},[24,2123,2073],{}," Установите ",[32,2126,26],{}," отдельно.",[87,2129,2131],{"className":89,"code":2130,"language":91,"meta":92,"style":92},"# Установка kubectl (актуальная версия)\ncurl -LO \"https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl\"\nsudo install -o root -g root -m 0755 kubectl /usr/local/bin/kubectl\nkubectl version --client\n",[32,2132,2133,2138,2158,2184],{"__ignoreMap":92},[96,2134,2135],{"class":98,"line":99},[96,2136,2137],{"class":102},"# Установка kubectl (актуальная версия)\n",[96,2139,2140,2142,2144,2147,2149,2152,2155],{"class":98,"line":106},[96,2141,58],{"class":109},[96,2143,1607],{"class":112},[96,2145,2146],{"class":116}," \"https://dl.k8s.io/release/$(",[96,2148,58],{"class":109},[96,2150,2151],{"class":112}," -L",[96,2153,2154],{"class":112}," -s",[96,2156,2157],{"class":116}," https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl\"\n",[96,2159,2160,2162,2164,2166,2169,2172,2174,2176,2178,2181],{"class":98,"line":139},[96,2161,51],{"class":109},[96,2163,342],{"class":116},[96,2165,133],{"class":112},[96,2167,2168],{"class":116}," root",[96,2170,2171],{"class":112}," -g",[96,2173,2168],{"class":116},[96,2175,1294],{"class":112},[96,2177,1297],{"class":112},[96,2179,2180],{"class":116}," kubectl",[96,2182,2183],{"class":116}," /usr/local/bin/kubectl\n",[96,2185,2186,2188,2190],{"class":98,"line":146},[96,2187,26],{"class":109},[96,2189,430],{"class":116},[96,2191,433],{"class":112},[82,2193,2195,2196,314,2199],{"id":2194},"проблема-ошибки-вида-error-failed-to-pull-image-или-imagepullbackoff","Проблема: Ошибки вида ",[32,2197,2198],{},"Error: failed to pull image ...",[32,2200,2201],{},"ImagePullBackOff",[21,2203,2204,2206,2207,2210,2211,2214],{},[24,2205,2073],{}," Minikube/Docker не может скачать образ из ",[32,2208,2209],{},"k8s.gcr.io",". Чаще всего это проблема с сетью или DNS. Проверьте доступ в интернет с машины. Можно попробовать использовать другой реестр (например, ",[32,2212,2213],{},"registry.k8s.io",") или настроить прокси для Docker.",[82,2216,2062,2218,2221],{"id":2217},"проблема-minikube-ssh-не-работает-или-зависает",[32,2219,2220],{},"minikube ssh"," не работает или зависает",[21,2223,2224,2226,2227,2230,2231,2234,2235,2237],{},[24,2225,2073],{}," Проблема с драйвером. Убедитесь, что Docker-контейнер с кластером существует: ",[32,2228,2229],{},"docker ps | grep minikube",". Если контейнер не запущен, попробуйте ",[32,2232,2233],{},"minikube start --alsologtostderr"," для подробного лога и ",[32,2236,2101],{}," с последующим чистым запуском.",[920,2239,2240],{},"html pre.shiki code .sJ8bj, html code.shiki .sJ8bj{--shiki-default:#6A737D;--shiki-dark:#6A737D}html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .szBVR, html code.shiki .szBVR{--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":92,"searchDepth":106,"depth":106,"links":2242},[2243,2244,2245,2252,2253],{"id":18,"depth":106,"text":19},{"id":37,"depth":106,"text":38},{"id":1222,"depth":106,"text":1223,"children":2246},[2247,2248,2249,2250,2251],{"id":1226,"depth":139,"text":1227},{"id":1570,"depth":139,"text":1571},{"id":1656,"depth":139,"text":1657},{"id":1742,"depth":139,"text":1743},{"id":1913,"depth":139,"text":1914},{"id":725,"depth":106,"text":726},{"id":754,"depth":106,"text":755,"children":2254},[2255,2257,2259,2261],{"id":2061,"depth":139,"text":2256},"Проблема: minikube start завершается с ошибкой Failed to start host: ...",{"id":2114,"depth":139,"text":2258},"Проблема: kubectl не найден или kubectl: command not found",{"id":2194,"depth":139,"text":2260},"Проблема: Ошибки вида Error: failed to pull image ... или ImagePullBackOff",{"id":2217,"depth":139,"text":2262},"Проблема: minikube ssh не работает или зависает","2026-02-16 12:43:21","Настройте локальный кластер Kubernetes на Linux за 10 минут. Пошаговая инструкция по установке Minikube, Docker и настройке драйвера. Проверенный способ для разработки.","medium","15-30 мин",[2268,2271,2274,2277],{"question":2269,"answer":2270},"Сколько RAM нужно для Minikube?","Минимум 2 ГБ, рекомендуется 4 ГБ и более. Для образов с большим количеством компонентов может потребоваться 8 ГБ.",{"question":2272,"answer":2273},"Можно ли использовать Minikube без Docker?","Да, Minikube поддерживает другие драйверы (virtualbox, kvm2, podman). Но Docker — самый простой и распространённый вариант на Linux.",{"question":2275,"answer":2276},"Почему Minikube не запускается после установки?","Чаще всего причина в отсутствии/недостаточных ресурсах (RAM/CPU), конфликте портов или неправильно настроенном драйвере. Проверьте вывод `minikube status` и логи `minikube logs`.",{"question":2278,"answer":2279},"Minikube подходит для продакшена?","Нет. Minikube предназначен только для локальной разработки, тестирования и обучения. Для продакшена используйте полноценные Kubernetes-распределения.",[2281,2284,2287,2290,2293],{"name":2282,"text":2283},"Установите Docker","Minikube использует Docker как драйвер по умолчанию на Linux. Установите и запустите службу Docker.",{"name":2285,"text":2286},"Скачайте и установите Minikube","Загрузите последний бинарный файл Minikube и разместите его вPATH.",{"name":2288,"text":2289},"Запустите Minikube кластер","Инициализируйте кластер с выбранным драйвером (docker) и заданной памятью.",{"name":2291,"text":2292},"Проверьте статус и настройте kubectl","Убедитесь, что кластер работает, и настройте контекст kubectl для управления им.",{"name":2294,"text":2295},"Дополнительная настройка (опционально)","Настройте драйвер по умолчанию, добавьте алиас или измените параметры кластера.","PT30M",[2298,2299,2300,2301,2302,2303,2304,2305],"установка minikube на ubuntu","minikube linux установка с docker","как запустить minikube на debian","локальный kubernetes minikube","minikube драйвер docker linux","ошибка minikube start","minikube requirements linux","k8s локально ubuntu",{},[995,2308,2309],"/guides/linux/docker-install-ubuntu","/errors/linux/minikube-start-failed",{"title":1131,"description":2264},"guides/linux/setup-minikube","Это руководство поможет вам установить и запустить Minikube — инструмент для локального запуска Kubernetes — на системах на базе Ubuntu/Debian. Вы получите работающий однокластерный Kubernetes-окружение для тестирования и разработки.",[2314,721,1554,2315,2316,2317,1010],"kubernetes","контейнеризация","devops","ubuntu","f6VjMrigsNua4VNM4c0GCUBZpOvcCMPL3AJOhSyj-XI",{"id":2320,"title":2321,"appliesTo":2322,"author":11,"body":2327,"canonical":950,"code":950,"createdAt":3029,"description":3030,"difficulty":2265,"draft":954,"estimatedTime":955,"extension":956,"faq":3031,"howToSteps":3044,"howToTotalTime":3063,"image":950,"keywords":3064,"locale":993,"meta":3075,"navigation":142,"path":999,"platform":996,"related":3076,"section":3080,"seo":3081,"severity":3082,"stem":3083,"summary":3084,"tags":3085,"twitterCreator":950,"twitterSite":950,"type":1012,"updatedAt":3029,"__hash__":3086},"content_ru/guides/linux/install-docker-ce.md","Установка Docker CE на Linux: подробная инструкция для Ubuntu, CentOS",[2323,2324,2325,2326],"Ubuntu 22.04 LTS","Debian 11","CentOS 8 Stream","Fedora 38",{"type":13,"value":2328,"toc":3010},[2329,2333,2336,2339,2343,2346,2377,2382,2386,2389,2393,2396,2430,2465,2469,2472,2511,2536,2551,2555,2558,2561,2622,2654,2657,2675,2688,2702,2706,2709,2712,2745,2779,2782,2807,2817,2819,2823,2828,2888,2900,2904,2910,2923,2926,2932,2934,2937,2991,3007],[16,2330,2332],{"id":2331},"введение","Введение",[21,2334,2335],{},"Docker Community Edition (CE) — это бесплатная версия Docker, которая позволяет упаковывать приложения и их зависимости в переносимые контейнеры. Установка Docker CE на Linux открывает возможности для быстрой разработки, тестирования и развертывания программного обеспечения в изолированной среде. Этот гайд поможет вам настроить Docker на популярных дистрибутивах Linux, таких как Ubuntu, Debian, CentOS и Fedora, используя официальный репозиторий Docker.",[21,2337,2338],{},"После выполнения инструкции вы сможете запускать Docker-контейнеры, управлять образами и сетями, а также использовать инструменты вроде Docker Compose. Процесс занимает около 10–15 минут и требует базовых знаний работы с терминалом.",[16,2340,2342],{"id":2341},"требования","Требования",[21,2344,2345],{},"Перед началом установки убедитесь, что ваша система соответствует следующим требованиям:",[595,2347,2348,2354,2360,2366],{},[46,2349,2350,2353],{},[24,2351,2352],{},"64-битная Linux-система",": Docker CE поддерживает x86_64, ARM и другие архитектуры, но в этом гайде фокус на x86_64.",[46,2355,2356,2359],{},[24,2357,2358],{},"Доступ к терминалу"," с правами суперпользователя (sudo) или root.",[46,2361,2362,2365],{},[24,2363,2364],{},"Подключение к интернету"," для загрузки пакетов и репозитория Docker.",[46,2367,2368,2371,2372,52],{},[24,2369,2370],{},"Поддерживаемый дистрибутив",": Ubuntu 20.04+, Debian 10+, CentOS 7+, Fedora 30+. Актуальный список поддерживаемых версий смотрите в ",[210,2373,2376],{"href":2374,"rel":2375},"https://docs.docker.com/engine/install/",[214],"официальной документации Docker",[192,2378,2379],{},[21,2380,2381],{},"💡 Совет: Если вы используете менее распространённый дистрибутив, проверьте, есть ли в нём пакет Docker в официальных репозиториях, но для последних версий рекомендуется официальный репозиторий Docker.",[16,2383,2385],{"id":2384},"шаг-1-обновление-системы-и-установка-зависимостей","Шаг 1: Обновление системы и установка зависимостей",[21,2387,2388],{},"Перед добавлением репозитория Docker обновите список пакетов и установите необходимые утилиты. Команды отличаются для дистрибутивов на базе Debian/Ubuntu (apt) и CentOS/Fedora (yum/dnf).",[82,2390,2392],{"id":2391},"для-ubuntu-и-debian","Для Ubuntu и Debian",[21,2394,2395],{},"Выполните следующие команды в терминале:",[87,2397,2399],{"className":89,"code":2398,"language":91,"meta":92,"style":92},"sudo apt update\nsudo apt install -y apt-transport-https ca-certificates curl software-properties-common\n",[32,2400,2401,2410],{"__ignoreMap":92},[96,2402,2403,2405,2408],{"class":98,"line":99},[96,2404,51],{"class":109},[96,2406,2407],{"class":116}," apt",[96,2409,190],{"class":116},[96,2411,2412,2414,2416,2418,2420,2423,2425,2427],{"class":98,"line":106},[96,2413,51],{"class":109},[96,2415,2407],{"class":116},[96,2417,342],{"class":116},[96,2419,345],{"class":112},[96,2421,2422],{"class":116}," apt-transport-https",[96,2424,1270],{"class":116},[96,2426,1273],{"class":116},[96,2428,2429],{"class":116}," software-properties-common\n",[595,2431,2432,2438,2444,2450,2455],{},[46,2433,2434,2437],{},[32,2435,2436],{},"apt update"," обновляет кэш пакетов.",[46,2439,2440,2443],{},[32,2441,2442],{},"apt-transport-https"," позволяет использовать HTTPS-репозитории.",[46,2445,2446,2449],{},[32,2447,2448],{},"ca-certificates"," обеспечивает проверку SSL-сертификатов.",[46,2451,2452,2454],{},[32,2453,58],{}," используется для загрузки GPG-ключа.",[46,2456,2457,2460,2461,2464],{},[32,2458,2459],{},"software-properties-common"," добавляет команду ",[32,2462,2463],{},"add-apt-repository"," (необязательно, но полезно).",[82,2466,2468],{"id":2467},"для-centos-и-fedora","Для CentOS и Fedora",[21,2470,2471],{},"Для CentOS 7/8 и Fedora используйте yum или dnf:",[87,2473,2475],{"className":89,"code":2474,"language":91,"meta":92,"style":92},"sudo yum update -y\nsudo yum install -y yum-utils device-mapper-persistent-data lvm2 curl\n",[32,2476,2477,2489],{"__ignoreMap":92},[96,2478,2479,2481,2483,2486],{"class":98,"line":99},[96,2480,51],{"class":109},[96,2482,298],{"class":116},[96,2484,2485],{"class":116}," update",[96,2487,2488],{"class":112}," -y\n",[96,2490,2491,2493,2495,2497,2499,2502,2505,2508],{"class":98,"line":106},[96,2492,51],{"class":109},[96,2494,298],{"class":116},[96,2496,342],{"class":116},[96,2498,345],{"class":112},[96,2500,2501],{"class":116}," yum-utils",[96,2503,2504],{"class":116}," device-mapper-persistent-data",[96,2506,2507],{"class":116}," lvm2",[96,2509,2510],{"class":116}," curl\n",[595,2512,2513,2522,2531],{},[46,2514,2515,2518,2519,52],{},[32,2516,2517],{},"yum-utils"," предоставляет утилиту ",[32,2520,2521],{},"yum-config-manager",[46,2523,2524,2085,2527,2530],{},[32,2525,2526],{},"device-mapper-persistent-data",[32,2528,2529],{},"lvm2"," требуются для хранилища Docker.",[46,2532,2533,2535],{},[32,2534,58],{}," для загрузки ключа.",[192,2537,2538],{},[21,2539,2540,2541,873,2544,2547,2548,2550],{},"⚠️ Важно: На Fedora можно использовать ",[32,2542,2543],{},"dnf",[32,2545,2546],{},"yum",", но команды совместимы. Убедитесь, что ",[32,2549,2517],{}," установлен.",[16,2552,2554],{"id":2553},"шаг-2-добавление-официального-репозитория-docker","Шаг 2: Добавление официального репозитория Docker",[21,2556,2557],{},"Docker предоставляет собственный репозиторий с актуальными версиями пакетов. Добавьте GPG-ключ Docker для проверки подлинности пакетов и настройте репозиторий.",[82,2559,2392],{"id":2560},"для-ubuntu-и-debian-1",[87,2562,2564],{"className":89,"code":2563,"language":91,"meta":92,"style":92},"curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg\necho \"deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable\" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null\n",[32,2565,2566,2587],{"__ignoreMap":92},[96,2567,2568,2570,2572,2574,2576,2578,2580,2582,2584],{"class":98,"line":99},[96,2569,58],{"class":109},[96,2571,113],{"class":112},[96,2573,1312],{"class":116},[96,2575,121],{"class":120},[96,2577,124],{"class":109},[96,2579,127],{"class":116},[96,2581,130],{"class":112},[96,2583,133],{"class":112},[96,2585,2586],{"class":116}," /usr/share/keyrings/docker-archive-keyring.gpg\n",[96,2588,2589,2591,2594,2596,2598,2601,2604,2607,2610,2612,2614,2616,2618,2620],{"class":98,"line":106},[96,2590,155],{"class":112},[96,2592,2593],{"class":116}," \"deb [arch=$(",[96,2595,1363],{"class":109},[96,2597,1366],{"class":112},[96,2599,2600],{"class":116},") signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(",[96,2602,2603],{"class":109},"lsb_release",[96,2605,2606],{"class":112}," -cs",[96,2608,2609],{"class":116},") stable\"",[96,2611,121],{"class":120},[96,2613,124],{"class":109},[96,2615,165],{"class":116},[96,2617,1409],{"class":116},[96,2619,1412],{"class":120},[96,2621,1415],{"class":116},[595,2623,2624,2630,2644],{},[46,2625,2626,2627,52],{},"Первая команда загружает GPG-ключ Docker и сохраняет его в ",[32,2628,2629],{},"/usr/share/keyrings/docker-archive-keyring.gpg",[46,2631,2632,2633,2636,2637,2639,2640,2643],{},"Вторая команда добавляет репозиторий в ",[32,2634,2635],{},"/etc/apt/sources.list.d/docker.list",". Замените ",[32,2638,2317],{}," на ",[32,2641,2642],{},"debian"," для Debian.",[46,2645,2646,2649,2650,2653],{},[32,2647,2648],{},"$(lsb_release -cs)"," автоматически определяет кодовое имя вашего дистрибутива (например, ",[32,2651,2652],{},"jammy"," для Ubuntu 22.04).",[82,2655,2468],{"id":2656},"для-centos-и-fedora-1",[87,2658,2660],{"className":89,"code":2659,"language":91,"meta":92,"style":92},"sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo\n",[32,2661,2662],{"__ignoreMap":92},[96,2663,2664,2666,2669,2672],{"class":98,"line":99},[96,2665,51],{"class":109},[96,2667,2668],{"class":116}," yum-config-manager",[96,2670,2671],{"class":112}," --add-repo",[96,2673,2674],{"class":116}," https://download.docker.com/linux/centos/docker-ce.repo\n",[595,2676,2677],{},[46,2678,2679,2680,2683,2684,52],{},"Эта команда добавляет репозиторий Docker для CentOS. Для Fedora репозиторий аналогичен, но иногда требуется использовать ",[32,2681,2682],{},"https://download.docker.com/linux/fedora/docker-ce.repo",". Если возникают ошибки, проверьте актуальный URL в ",[210,2685,2687],{"href":2374,"rel":2686},[214],"документации Docker",[192,2689,2690],{},[21,2691,2692,2693,2695,2696,2698,2699,52],{},"💡 Совет: Если команда ",[32,2694,2521],{}," недоступна, установите ",[32,2697,2517],{}," (см. Шаг 1) или вручную создайте файл репозитория в ",[32,2700,2701],{},"/etc/yum.repos.d/docker-ce.repo",[16,2703,2705],{"id":2704},"шаг-3-установка-docker-ce","Шаг 3: Установка Docker CE",[21,2707,2708],{},"После настройки репозитория установите пакеты Docker CE и дополнительные компоненты, такие как Docker Compose (в виде плагина) и BuildKit.",[82,2710,2392],{"id":2711},"для-ubuntu-и-debian-2",[87,2713,2715],{"className":89,"code":2714,"language":91,"meta":92,"style":92},"sudo apt update\nsudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin\n",[32,2716,2717,2725],{"__ignoreMap":92},[96,2718,2719,2721,2723],{"class":98,"line":99},[96,2720,51],{"class":109},[96,2722,2407],{"class":116},[96,2724,190],{"class":116},[96,2726,2727,2729,2731,2733,2735,2737,2739,2741,2743],{"class":98,"line":106},[96,2728,51],{"class":109},[96,2730,2407],{"class":116},[96,2732,342],{"class":116},[96,2734,345],{"class":112},[96,2736,1449],{"class":116},[96,2738,1452],{"class":116},[96,2740,1455],{"class":116},[96,2742,1458],{"class":116},[96,2744,1461],{"class":116},[595,2746,2747,2753,2761,2767,2773],{},[46,2748,2749,2752],{},[32,2750,2751],{},"docker-ce"," — основной движок Docker.",[46,2754,2755,2758,2759,52],{},[32,2756,2757],{},"docker-ce-cli"," — клиентская утилита ",[32,2760,1554],{},[46,2762,2763,2766],{},[32,2764,2765],{},"containerd.io"," — управление контейнерами.",[46,2768,2769,2772],{},[32,2770,2771],{},"docker-buildx-plugin"," — расширение для сборки образов.",[46,2774,2775,2778],{},[32,2776,2777],{},"docker-compose-plugin"," — плагин для Docker Compose (вместо отдельного бинарника).",[82,2780,2468],{"id":2781},"для-centos-и-fedora-2",[87,2783,2785],{"className":89,"code":2784,"language":91,"meta":92,"style":92},"sudo yum install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin\n",[32,2786,2787],{"__ignoreMap":92},[96,2788,2789,2791,2793,2795,2797,2799,2801,2803,2805],{"class":98,"line":99},[96,2790,51],{"class":109},[96,2792,298],{"class":116},[96,2794,342],{"class":116},[96,2796,345],{"class":112},[96,2798,1449],{"class":116},[96,2800,1452],{"class":116},[96,2802,1455],{"class":116},[96,2804,1458],{"class":116},[96,2806,1461],{"class":116},[21,2808,2809,2810,2812,2813,2639,2815,52],{},"Пакеты имеют те же имена. Если вы используете ",[32,2811,2543],{}," на Fedora, замените ",[32,2814,2546],{},[32,2816,2543],{},[410,2818],{},[16,2820,2822],{"id":2821},"шаг-4-настройка-службы-docker-и-прав-пользователя","Шаг 4: Настройка службы Docker и прав пользователя",[21,2824,2825,2826,52],{},"По умолчанию Docker требует прав суперпользователя. Для удобства настройте автозапуск службы и добавьте вашего пользователя в группу ",[32,2827,1554],{},[87,2829,2831],{"className":89,"code":2830,"language":91,"meta":92,"style":92},"# Запустите службу Docker\nsudo systemctl start docker\n\n# Включите автозапуск при загрузке системы\nsudo systemctl enable docker\n\n# Добавьте текущего пользователя в группу docker\nsudo usermod -aG docker $USER\n",[32,2832,2833,2838,2848,2852,2857,2867,2871,2876],{"__ignoreMap":92},[96,2834,2835],{"class":98,"line":99},[96,2836,2837],{"class":102},"# Запустите службу Docker\n",[96,2839,2840,2842,2844,2846],{"class":98,"line":106},[96,2841,51],{"class":109},[96,2843,1519],{"class":116},[96,2845,1522],{"class":116},[96,2847,1525],{"class":116},[96,2849,2850],{"class":98,"line":139},[96,2851,143],{"emptyLinePlaceholder":142},[96,2853,2854],{"class":98,"line":146},[96,2855,2856],{"class":102},"# Включите автозапуск при загрузке системы\n",[96,2858,2859,2861,2863,2865],{"class":98,"line":152},[96,2860,51],{"class":109},[96,2862,1519],{"class":116},[96,2864,1535],{"class":116},[96,2866,1525],{"class":116},[96,2868,2869],{"class":98,"line":171},[96,2870,143],{"emptyLinePlaceholder":142},[96,2872,2873],{"class":98,"line":176},[96,2874,2875],{"class":102},"# Добавьте текущего пользователя в группу docker\n",[96,2877,2878,2880,2882,2884,2886],{"class":98,"line":182},[96,2879,51],{"class":109},[96,2881,1480],{"class":116},[96,2883,1483],{"class":112},[96,2885,1486],{"class":116},[96,2887,1489],{"class":467},[192,2889,2890],{},[21,2891,2892,2893,2895,2896,2899],{},"⚠️ Важно: После добавления пользователя в группу ",[32,2894,1554],{}," необходимо выйти из системы и войти заново, чтобы изменения вступили в силу. В качестве альтернативы выполните ",[32,2897,2898],{},"newgrp docker"," в текущем терминале, но это сработает только для этого сеанса.",[16,2901,2903],{"id":2902},"шаг-5-проверка-установки","Шаг 5: Проверка установки",[21,2905,2906,2907,455],{},"Чтобы убедиться, что Docker работает корректно, запустите тестовый контейнер ",[32,2908,2909],{},"hello-world",[87,2911,2913],{"className":89,"code":2912,"language":91,"meta":92,"style":92},"docker run hello-world\n",[32,2914,2915],{"__ignoreMap":92},[96,2916,2917,2919,2921],{"class":98,"line":99},[96,2918,1554],{"class":109},[96,2920,1557],{"class":116},[96,2922,1560],{"class":116},[21,2924,2925],{},"Если установка прошла успешно, вы увидите приветственное сообщение, подтверждающее, что Docker может извлекать образы и запускать контейнеры. Пример вывода:",[87,2927,2930],{"className":2928,"code":2929,"language":442},[440],"Hello from Docker!\nThis message shows that your installation appears to be working correctly.\n...\n",[32,2931,2929],{"__ignoreMap":92},[16,2933,755],{"id":754},[21,2935,2936],{},"При установке Docker CE на Linux могут возникнуть следующие типичные ошибки:",[595,2938,2939,2951,2964,2979,2985],{},[46,2940,2941,2944,2945,2947,2948,52],{},[24,2942,2943],{},"Ошибка доступа (permission denied)",": Убедитесь, что пользователь добавлен в группу ",[32,2946,1554],{}," (см. Шаг 4) и перезаlogged in. Проверьте членство в группе: ",[32,2949,2950],{},"groups $USER",[46,2952,2953,2956,2957,2960,2961,52],{},[24,2954,2955],{},"Служба Docker не запущена",": Проверьте статус службы: ",[32,2958,2959],{},"sudo systemctl status docker",". Если она неактивна, запустите её: ",[32,2962,2963],{},"sudo systemctl start docker",[46,2965,2966,2969,2970,2973,2974,2639,2976,2978],{},[24,2967,2968],{},"Ошибка добавления репозитория",": Проверьте, что GPG-ключ корректно добавлен (",[32,2971,2972],{},"ls /usr/share/keyrings/docker-archive-keyring.gpg",") и URL репозитория соответствует вашему дистрибутиву. Для Debian замените ",[32,2975,2317],{},[32,2977,2642],{}," в команде добавления репозитория.",[46,2980,2981,2984],{},[24,2982,2983],{},"Конфликты пакетов на Fedora",": Fedora может иметь собственные версии пакетов Docker в репозиториях. Если возникают конфликты, отключите репозиторий Fedora для Docker или используйте официальный репозиторий Docker с указанием версии.",[46,2986,2987,2990],{},[24,2988,2989],{},"Устаревшие зависимости",": На старых дистрибутивах могут отсутствовать пакеты. Обновите систему или рассмотрите использование более новой версии дистрибутива.",[21,2992,2993,2994,2997,2998,314,3003,52],{},"Если проблема не решена, проверьте логи Docker: ",[32,2995,2996],{},"sudo journalctl -u docker.service"," и поищите решение в ",[210,2999,3002],{"href":3000,"rel":3001},"https://forums.docker.com/",[214],"сообществе Docker",[210,3004,3006],{"href":2374,"rel":3005},[214],"официальной документации",[920,3008,3009],{},"html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .szBVR, html code.shiki .szBVR{--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .sJ8bj, html code.shiki .sJ8bj{--shiki-default:#6A737D;--shiki-dark:#6A737D}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}",{"title":92,"searchDepth":106,"depth":106,"links":3011},[3012,3013,3014,3018,3022,3026,3027,3028],{"id":2331,"depth":106,"text":2332},{"id":2341,"depth":106,"text":2342},{"id":2384,"depth":106,"text":2385,"children":3015},[3016,3017],{"id":2391,"depth":139,"text":2392},{"id":2467,"depth":139,"text":2468},{"id":2553,"depth":106,"text":2554,"children":3019},[3020,3021],{"id":2560,"depth":139,"text":2392},{"id":2656,"depth":139,"text":2468},{"id":2704,"depth":106,"text":2705,"children":3023},[3024,3025],{"id":2711,"depth":139,"text":2392},{"id":2781,"depth":139,"text":2468},{"id":2821,"depth":106,"text":2822},{"id":2902,"depth":106,"text":2903},{"id":754,"depth":106,"text":755},"2026-02-17 14:10:16","Узнайте, как установить Docker Community Edition на Linux за 10 минут. Пошаговое руководство для Ubuntu, Debian, CentOS, Fedora. Начните работать с контейнерами без лишних сложностей.",[3032,3035,3038,3041],{"question":3033,"answer":3034},"Требуется ли перезагрузка после установки Docker?","Нет, перезагрузка не требуется. После установки можно сразу запускать контейнеры, но если вы добавляли пользователя в группу docker, нужно выйти и зайти заново или выполнить newgrp docker.",{"question":3036,"answer":3037},"Можно ли установить Docker на Raspberry Pi?","Да, для ARM-архитектуры используйте Docker CE для Linux на ARM. Инструкция аналогична, но репозиторий может отличаться. Официальная документация Docker имеет раздел для Raspberry Pi.",{"question":3039,"answer":3040},"Что делать, если команда docker выдает 'permission denied'?","Добавьте текущего пользователя в группу docker: sudo usermod -aG docker $USER, затем выйдите и зайдите заново. Это предоставит права без использования sudo.",{"question":3042,"answer":3043},"Как обновить Docker до новой версии?","Выполните обновление пакетов: sudo apt update && sudo apt upgrade docker-ce для Ubuntu или sudo yum update docker-ce для CentOS. Docker обновится из репозитория.",[3045,3048,3051,3054,3057,3060],{"name":3046,"text":3047},"Обновите систему и установите зависимости","Обновите пакеты и установите необходимые утилиты, такие как curl и gnupg, в зависимости от вашего дистрибутива.",{"name":3049,"text":3050},"Добавьте официальный репозиторий Docker","Используйте curl для добавления GPG-ключа Docker и настройте репозиторий для вашего дистрибутива.",{"name":3052,"text":3053},"Установите Docker CE и связанные пакеты","Установите пакеты docker-ce, docker-ce-cli, containerd.io и плагины с помощью менеджера пакетов.",{"name":3055,"text":3056},"Запустите службу Docker и настройте автозапуск","Активируйте и запустите службу systemd для Docker, чтобы она работала после загрузки.",{"name":3058,"text":3059},"Добавьте пользователя в группу docker","Чтобы избежать использования sudo, добавьте вашего пользователя в группу docker и перезайдите в систему.",{"name":3061,"text":3062},"Проверьте установку с помощью hello-world","Выполните docker run hello-world, чтобы убедиться, что Docker работает корректно.","PT15M",[3065,3066,3067,3068,3069,3070,3071,3072,3073,3074],"установка docker ce на linux","docker ce установка ubuntu","как установить docker на centos","инструкция по установке docker community edition","docker для linux шаги","установить docker на debian","docker compose установка linux","ошибка при установке docker linux","настройка docker после установки","docker группа пользователей",{},[3077,3078,3079],"/guides/linux/docker-basics","/guides/linux/manage-docker-images","/errors/linux/docker-permission-denied","Гайды Docker",{"title":2321,"description":3030},"low","guides/linux/install-docker-ce","Этот гайд описывает установку Docker CE на Linux-дистрибутивы. Вы научитесь добавлять репозиторий, устанавливать пакеты и настраивать Docker для использования.",[1554,1008,996,2315,2316,2751],"Dn-Hs17xSqO_amCq_cokxiRcIQAABjKnCyyw3LiOX8Y",{"id":3088,"title":3089,"appliesTo":3090,"author":11,"body":3092,"canonical":950,"code":3126,"createdAt":3732,"description":3733,"difficulty":2265,"draft":954,"estimatedTime":955,"extension":956,"faq":3734,"howToSteps":3747,"howToTotalTime":3063,"image":950,"keywords":3763,"locale":993,"meta":3774,"navigation":142,"path":1000,"platform":996,"related":3775,"section":3779,"seo":3780,"severity":3781,"stem":3782,"summary":3783,"tags":3784,"twitterCreator":950,"twitterSite":950,"type":3788,"updatedAt":3732,"__hash__":3789},"content_ru/errors/linux/kubectl-command-not-found.md","Решение ошибки 'kubectl command not found' на Linux",[7,3091,9,10],"CentOS 7+",{"type":13,"value":3093,"toc":3722},[3094,3098,3121,3128,3132,3192,3196,3200,3205,3210,3247,3251,3271,3275,3295,3299,3305,3388,3392,3399,3607,3611,3624,3665,3669,3719],[16,3095,3097],{"id":3096},"что-означает-ошибка-kubectl-command-not-found","Что означает ошибка 'kubectl: command not found'",[21,3099,3100,3101,3104,3105,3108,3109,3111,3112,3114,3115,3117,3118,3120],{},"Ошибка ",[24,3102,3103],{},"'kubectl: command not found'"," (или ",[24,3106,3107],{},"'bash: kubectl: command not found'",") возникает в терминале Linux, когда система не может найти исполняемый файл команды ",[32,3110,26],{}," в директориях, перечисленных в переменной окружения ",[32,3113,454],{},". Это означает, что либо ",[32,3116,26],{}," не установлен на вашей системе, либо он установлен, но его путь не добавлен в ",[32,3119,454],{},", либо путь указан некорректно.",[21,3122,3123,3124,3127],{},"Ошибка обычно сопровождается кодом выхода ",[24,3125,3126],{},"127"," (в bash), что указывает на то, что команда не найдена.",[16,3129,3131],{"id":3130},"причины-возникновения","Причины возникновения",[43,3133,3134,3143,3161,3173,3186],{},[46,3135,3136,3139,3140,3142],{},[24,3137,3138],{},"Kubectl не установлен",". Вы пытаетесь использовать ",[32,3141,26],{}," без предварительной установки клиента Kubernetes.",[46,3144,3145,3148,3149,3151,3152,314,3155,3158,3159,52],{},[24,3146,3147],{},"Kubectl установлен, но не в PATH",". Возможно, вы установили ",[32,3150,26],{}," в кастомную директорию (например, ",[32,3153,3154],{},"~/bin",[32,3156,3157],{},"/opt/kubectl","), но эта директория не включена в переменную ",[32,3160,454],{},[46,3162,3163,3166,3167,3169,3170,3172],{},[24,3164,3165],{},"Неправильный путь в PATH",". В ",[32,3168,454],{}," указан неверный путь к исполняемому файлу ",[32,3171,26],{},", например, из-за опечатки или изменения расположения файла.",[46,3174,3175,3178,3179,3181,3182,826,3184,52],{},[24,3176,3177],{},"Проблемы с оболочкой",". Используется оболочка, которая не загружает конфигурационные файлы (например, ",[32,3180,829],{},"), где добавлен ",[32,3183,26],{},[32,3185,454],{},[46,3187,3188,3191],{},[24,3189,3190],{},"Повреждение установки",". Kubectl установлен, но исполняемый файл отсутствует или поврежден.",[16,3193,3195],{"id":3194},"способы-решения","Способы решения",[82,3197,3199],{"id":3198},"способ-1-установка-kubectl","Способ 1: Установка kubectl",[21,3201,714,3202,3204],{},[32,3203,26],{}," не установлен, необходимо его установить. Существует несколько способов установки в зависимости от дистрибутива Linux.",[3206,3207,3209],"h4",{"id":3208},"для-ubuntudebian","Для Ubuntu/Debian:",[87,3211,3213],{"className":89,"code":3212,"language":91,"meta":92,"style":92},"# Обновление индекса пакетов\nsudo apt-get update\n\n# Установка kubectl\nsudo apt-get install kubectl\n",[32,3214,3215,3220,3228,3232,3237],{"__ignoreMap":92},[96,3216,3217],{"class":98,"line":99},[96,3218,3219],{"class":102},"# Обновление индекса пакетов\n",[96,3221,3222,3224,3226],{"class":98,"line":106},[96,3223,51],{"class":109},[96,3225,187],{"class":116},[96,3227,190],{"class":116},[96,3229,3230],{"class":98,"line":139},[96,3231,143],{"emptyLinePlaceholder":142},[96,3233,3234],{"class":98,"line":146},[96,3235,3236],{"class":102},"# Установка kubectl\n",[96,3238,3239,3241,3243,3245],{"class":98,"line":152},[96,3240,51],{"class":109},[96,3242,187],{"class":116},[96,3244,342],{"class":116},[96,3246,348],{"class":116},[3206,3248,3250],{"id":3249},"для-centosrhel","Для CentOS/RHEL:",[87,3252,3254],{"className":89,"code":3253,"language":91,"meta":92,"style":92},"# Установка kubectl через yum\nsudo yum install kubectl\n",[32,3255,3256,3261],{"__ignoreMap":92},[96,3257,3258],{"class":98,"line":99},[96,3259,3260],{"class":102},"# Установка kubectl через yum\n",[96,3262,3263,3265,3267,3269],{"class":98,"line":106},[96,3264,51],{"class":109},[96,3266,298],{"class":116},[96,3268,342],{"class":116},[96,3270,348],{"class":116},[3206,3272,3274],{"id":3273},"для-fedora","Для Fedora:",[87,3276,3278],{"className":89,"code":3277,"language":91,"meta":92,"style":92},"# Установка kubectl через dnf\nsudo dnf install kubectl\n",[32,3279,3280,3285],{"__ignoreMap":92},[96,3281,3282],{"class":98,"line":99},[96,3283,3284],{"class":102},"# Установка kubectl через dnf\n",[96,3286,3287,3289,3291,3293],{"class":98,"line":106},[96,3288,51],{"class":109},[96,3290,390],{"class":116},[96,3292,342],{"class":116},[96,3294,348],{"class":116},[3206,3296,3298],{"id":3297},"альтернативная-установка-через-официальный-репозиторий-kubernetes","Альтернативная установка через официальный репозиторий Kubernetes:",[21,3300,3301,3302,3304],{},"Вы можете установить ",[32,3303,26],{}," напрямую с сайта Kubernetes, что гарантирует последнюю версию:",[87,3306,3308],{"className":89,"code":3307,"language":91,"meta":92,"style":92},"# Скачивание последней стабильной версии (пример для amd64)\ncurl -LO \"https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl\"\n\n# Добавление прав на выполнение\nchmod +x kubectl\n\n# Перемещение в директорию в PATH (например, /usr/local/bin)\nsudo mv kubectl /usr/local/bin/\n\n# Проверка установки\nkubectl version --client\n",[32,3309,3310,3315,3331,3335,3340,3350,3354,3359,3371,3375,3380],{"__ignoreMap":92},[96,3311,3312],{"class":98,"line":99},[96,3313,3314],{"class":102},"# Скачивание последней стабильной версии (пример для amd64)\n",[96,3316,3317,3319,3321,3323,3325,3327,3329],{"class":98,"line":106},[96,3318,58],{"class":109},[96,3320,1607],{"class":112},[96,3322,2146],{"class":116},[96,3324,58],{"class":109},[96,3326,2151],{"class":112},[96,3328,2154],{"class":112},[96,3330,2157],{"class":116},[96,3332,3333],{"class":98,"line":139},[96,3334,143],{"emptyLinePlaceholder":142},[96,3336,3337],{"class":98,"line":146},[96,3338,3339],{"class":102},"# Добавление прав на выполнение\n",[96,3341,3342,3345,3348],{"class":98,"line":152},[96,3343,3344],{"class":109},"chmod",[96,3346,3347],{"class":116}," +x",[96,3349,348],{"class":116},[96,3351,3352],{"class":98,"line":171},[96,3353,143],{"emptyLinePlaceholder":142},[96,3355,3356],{"class":98,"line":176},[96,3357,3358],{"class":102},"# Перемещение в директорию в PATH (например, /usr/local/bin)\n",[96,3360,3361,3363,3366,3368],{"class":98,"line":182},[96,3362,51],{"class":109},[96,3364,3365],{"class":116}," mv",[96,3367,2180],{"class":116},[96,3369,3370],{"class":116}," /usr/local/bin/\n",[96,3372,3373],{"class":98,"line":277},[96,3374,143],{"emptyLinePlaceholder":142},[96,3376,3377],{"class":98,"line":282},[96,3378,3379],{"class":102},"# Проверка установки\n",[96,3381,3382,3384,3386],{"class":98,"line":287},[96,3383,26],{"class":109},[96,3385,430],{"class":116},[96,3387,433],{"class":112},[82,3389,3391],{"id":3390},"способ-2-настройка-переменной-path","Способ 2: Настройка переменной PATH",[21,3393,714,3394,3396,3397,52],{},[32,3395,26],{}," уже установлен, но команда не найдена, возможно, путь к исполняемому файлу не добавлен в ",[32,3398,454],{},[43,3400,3401,3451,3480,3541,3579],{},[46,3402,3403,455,3408],{},[24,3404,3405,3406],{},"Найдите расположение ",[32,3407,26],{},[87,3409,3411],{"className":89,"code":3410,"language":91,"meta":92,"style":92},"# Поиск в стандартных директориях\nsudo find / -name kubectl 2>/dev/null\n# Или если знаете примерный путь\nls /usr/local/bin/kubectl\n",[32,3412,3413,3418,3439,3444],{"__ignoreMap":92},[96,3414,3415],{"class":98,"line":99},[96,3416,3417],{"class":102},"# Поиск в стандартных директориях\n",[96,3419,3420,3422,3425,3428,3431,3433,3436],{"class":98,"line":106},[96,3421,51],{"class":109},[96,3423,3424],{"class":116}," find",[96,3426,3427],{"class":116}," /",[96,3429,3430],{"class":112}," -name",[96,3432,2180],{"class":116},[96,3434,3435],{"class":120}," 2>",[96,3437,3438],{"class":116},"/dev/null\n",[96,3440,3441],{"class":98,"line":139},[96,3442,3443],{"class":102},"# Или если знаете примерный путь\n",[96,3445,3446,3449],{"class":98,"line":146},[96,3447,3448],{"class":109},"ls",[96,3450,2183],{"class":116},[46,3452,3453,455,3458,3470,3473,3474,3476,3477,3479],{},[24,3454,3455,3456],{},"Проверьте текущий ",[32,3457,454],{},[87,3459,3461],{"className":89,"code":3460,"language":91,"meta":92,"style":92},"echo $PATH\n",[32,3462,3463],{"__ignoreMap":92},[96,3464,3465,3467],{"class":98,"line":99},[96,3466,155],{"class":112},[96,3468,3469],{"class":467}," $PATH\n",[3471,3472],"br",{},"Убедитесь, что директория, содержащая ",[32,3475,26],{}," (например, ",[32,3478,405],{},"), присутствует в выводе.",[46,3481,3482,3488,3489,3491,3492,3494,3495,3513,3515,3516,3518,3519,3521,3522,3524,3525],{},[24,3483,3484,3485,3487],{},"Если директории нет в ",[32,3486,454],{},", добавьте её",":\nОткройте файл ",[32,3490,829],{}," (для bash) или ",[32,3493,832],{}," (для zsh) в текстовом редакторе и добавьте строку:",[87,3496,3498],{"className":89,"code":3497,"language":91,"meta":92,"style":92},"export PATH=$PATH:/путь/к/директории\n",[32,3499,3500],{"__ignoreMap":92},[96,3501,3502,3505,3508,3510],{"class":98,"line":99},[96,3503,3504],{"class":120},"export",[96,3506,3507],{"class":467}," PATH",[96,3509,1592],{"class":120},[96,3511,3512],{"class":467},"$PATH:/путь/к/директории\n",[3471,3514],{},"Например, если ",[32,3517,26],{}," находится в ",[32,3520,405],{}," (что обычно так), и этой директории нет в ",[32,3523,454],{},", добавьте:",[87,3526,3528],{"className":89,"code":3527,"language":91,"meta":92,"style":92},"export PATH=$PATH:/usr/local/bin\n",[32,3529,3530],{"__ignoreMap":92},[96,3531,3532,3534,3536,3538],{"class":98,"line":99},[96,3533,3504],{"class":120},[96,3535,3507],{"class":467},[96,3537,1592],{"class":120},[96,3539,3540],{"class":467},"$PATH:/usr/local/bin\n",[46,3542,3543,455,3546,3576,3578],{},[24,3544,3545],{},"Примените изменения",[87,3547,3549],{"className":89,"code":3548,"language":91,"meta":92,"style":92},"source ~/.bashrc   # для bash\n# или\nsource ~/.zshrc    # для zsh\n",[32,3550,3551,3561,3566],{"__ignoreMap":92},[96,3552,3553,3555,3558],{"class":98,"line":99},[96,3554,510],{"class":112},[96,3556,3557],{"class":116}," ~/.bashrc",[96,3559,3560],{"class":102},"   # для bash\n",[96,3562,3563],{"class":98,"line":106},[96,3564,3565],{"class":102},"# или\n",[96,3567,3568,3570,3573],{"class":98,"line":139},[96,3569,510],{"class":112},[96,3571,3572],{"class":116}," ~/.zshrc",[96,3574,3575],{"class":102},"    # для zsh\n",[3471,3577],{},"Или просто перезапустите терминал.",[46,3580,3581,455,3587],{},[24,3582,3583,3584,3586],{},"Проверьте, что ",[32,3585,26],{}," теперь доступен",[87,3588,3590],{"className":89,"code":3589,"language":91,"meta":92,"style":92},"which kubectl\nkubectl version --client\n",[32,3591,3592,3599],{"__ignoreMap":92},[96,3593,3594,3597],{"class":98,"line":99},[96,3595,3596],{"class":112},"which",[96,3598,348],{"class":116},[96,3600,3601,3603,3605],{"class":98,"line":106},[96,3602,26],{"class":109},[96,3604,430],{"class":116},[96,3606,433],{"class":112},[82,3608,3610],{"id":3609},"способ-3-создание-символьной-ссылки","Способ 3: Создание символьной ссылки",[21,3612,714,3613,3615,3616,3618,3619,3476,3621,3623],{},[32,3614,26],{}," установлен в нестандартную директорию, и вы не хотите менять ",[32,3617,454],{},", можно создать символьную ссылку в директории, которая уже в ",[32,3620,454],{},[32,3622,405],{},"):",[87,3625,3627],{"className":89,"code":3626,"language":91,"meta":92,"style":92},"# Предположим, kubectl находится в /opt/kubectl/bin/kubectl\nsudo ln -s /opt/kubectl/bin/kubectl /usr/local/bin/kubectl\n\n# Проверка\nkubectl version --client\n",[32,3628,3629,3634,3648,3652,3657],{"__ignoreMap":92},[96,3630,3631],{"class":98,"line":99},[96,3632,3633],{"class":102},"# Предположим, kubectl находится в /opt/kubectl/bin/kubectl\n",[96,3635,3636,3638,3641,3643,3646],{"class":98,"line":106},[96,3637,51],{"class":109},[96,3639,3640],{"class":116}," ln",[96,3642,2154],{"class":112},[96,3644,3645],{"class":116}," /opt/kubectl/bin/kubectl",[96,3647,2183],{"class":116},[96,3649,3650],{"class":98,"line":139},[96,3651,143],{"emptyLinePlaceholder":142},[96,3653,3654],{"class":98,"line":146},[96,3655,3656],{"class":102},"# Проверка\n",[96,3658,3659,3661,3663],{"class":98,"line":152},[96,3660,26],{"class":109},[96,3662,430],{"class":116},[96,3664,433],{"class":112},[16,3666,3668],{"id":3667},"профилактика","Профилактика",[595,3670,3671,3682,3696,3709],{},[46,3672,3673,3679,3680,52],{},[24,3674,3675,3676,3678],{},"Устанавливайте ",[32,3677,26],{}," через официальные репозитории или менеджеры пакетов",", чтобы автоматически добавлять его в ",[32,3681,454],{},[46,3683,3684,3689,3690,3692,3693,3695],{},[24,3685,3686,3687,809],{},"Проверяйте ",[32,3688,454],{}," командой ",[32,3691,1070],{},", убедитесь, что директория с ",[32,3694,26],{}," включена.",[46,3697,3698,3701,3702,314,3704,3706,3707,52],{},[24,3699,3700],{},"Используйте стандартные пути"," для установки бинарных файлов, такие как ",[32,3703,405],{},[32,3705,408],{},", которые обычно уже в ",[32,3708,454],{},[46,3710,3711,3716,3717,69],{},[24,3712,3713,3714],{},"Если устанавливаете вручную, всегда добавляйте путь в ",[32,3715,454],{}," в конфигурационном файле оболочки (например, ",[32,3718,829],{},[920,3720,3721],{},"html pre.shiki code .sJ8bj, html code.shiki .sJ8bj{--shiki-default:#6A737D;--shiki-dark:#6A737D}html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .szBVR, html code.shiki .szBVR{--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}",{"title":92,"searchDepth":106,"depth":106,"links":3723},[3724,3725,3726,3731],{"id":3096,"depth":106,"text":3097},{"id":3130,"depth":106,"text":3131},{"id":3194,"depth":106,"text":3195,"children":3727},[3728,3729,3730],{"id":3198,"depth":139,"text":3199},{"id":3390,"depth":139,"text":3391},{"id":3609,"depth":139,"text":3610},{"id":3667,"depth":106,"text":3668},"2026-02-14 23:48:28","Исправление ошибки 'kubectl: command not found' на Linux. Пошаговая инструкция по установке kubectl и настройке PATH. Решение за 5 минут для Ubuntu, CentOS, Debian и Fedora.",[3735,3738,3741,3744],{"answer":3736,"question":3737},"Ошибка означает, что система не может найти исполняемый файл kubectl в директориях, указанных в переменной PATH. Это происходит, если kubectl не установлен или PATH настроен некорректно.","Почему возникает ошибка 'kubectl: command not found'?",{"answer":3739,"question":3740},"Выполните команду `which kubectl` или `kubectl version --client`. Если kubectl установлен, команда вернет путь к исполняемому файлу или версию клиента.","Как проверить, установлен ли kubectl?",{"answer":3742,"question":3743},"Вероятно, путь к kubectl не добавлен в переменную PATH. Добавьте директорию с kubectl в PATH или создайте символьную ссылку в /usr/local/bin.","Что делать, если kubectl установлен, но команда не найдена?",{"answer":3745,"question":3746},"Отредактируйте файл ~/.bashrc или ~/.bash_profile, добавьте строку `export PATH=$PATH:/путь/к/kubectl`, затем выполните `source ~/.bashrc`.","Как добавить kubectl в PATH?",[3748,3751,3754,3757,3760],{"name":3749,"text":3750},"Проверка наличия kubectl","Выполните `which kubectl` в терминале. Если команда возвращает путь, kubectl установлен; если ничего не выводит или сообщение 'not found', kubectl отсутствует или не в PATH.",{"name":3752,"text":3753},"Установка kubectl","В зависимости от дистрибутива, используйте менеджер пакетов: для Ubuntu/Debian `sudo apt-get install kubectl`, для CentOS/RHEF `sudo yum install kubectl`, для Fedora `sudo dnf install kubectl`. Или установите вручную с официального сайта Kubernetes.",{"name":3755,"text":3756},"Настройка PATH","Если kubectl установлен, но не найден, найдите путь к исполняемому файлу (например, /usr/local/bin/kubectl) и убедитесь, что эта директория есть в PATH. Проверьте PATH командой `echo $PATH`.",{"name":3758,"text":3759},"Добавление в PATH","Если путь отсутствует, добавьте его в ~/.bashrc: `export PATH=$PATH:/usr/local/bin`, затем выполните `source ~/.bashrc` или перезапустите терминал.",{"name":3761,"text":3762},"Проверка работы","После установки и настройки PATH выполните `kubectl version --client` для проверки версии клиента. Должна отобразиться информация о версии.",[3764,3765,3766,3767,3768,3769,3770,3771,3772,3773],"kubectl command not found","ошибка kubectl не найдена","bash kubectl command not found","установка kubectl на Linux","настроить PATH для kubectl","kubectl ошибка 127","kubectl не работает в терминале","как добавить kubectl в PATH","установить kubectl Ubuntu","kubectl command not found exit code 127",{},[3776,3777,3778],"/guides/linux/install-kubectl-on-linux","/errors/linux/kubectl-crashloopbackoff","/guides/linux/configure-kubectl-context","Ошибки Linux",{"title":3089,"description":3733},"high","errors/linux/kubectl-command-not-found","Статья объясняет причины ошибки 'kubectl: command not found' и предлагает пошаговые инструкции по установке kubectl и настройке переменной PATH для различных дистрибутивов Linux.",[3785,26,2314,91,3786,1008,3787,450],"ошибки linux","path","terminal","error","lNssNqXJA2rgc0VGPvoIQ33tTLOU7IQhydQROLiTHPE"]