> For the complete documentation index, see [llms.txt](https://xu-min-chang.gitbook.io/kubernetes/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://xu-min-chang.gitbook.io/kubernetes/setup/kubectl.md).

# kubectl 安裝

本章介紹 kubectl 的安裝方法。

## 安裝方法

### OSX

可以使用 Homebrew 或者 `curl` 下載 kubectl：

```bash
brew install kubectl
```

或者

```bash
curl -LO https://storage.googleapis.com/kubernetes-release/release/$(curl -s https://storage.googleapis.com/kubernetes-release/release/stable.txt)/bin/darwin/amd64/kubectl
```

### Linux

```bash
curl -LO https://storage.googleapis.com/kubernetes-release/release/$(curl -s https://storage.googleapis.com/kubernetes-release/release/stable.txt)/bin/linux/amd64/kubectl
```

### Windows

```bash
curl -LO https://storage.googleapis.com/kubernetes-release/release/$(curl -s https://storage.googleapis.com/kubernetes-release/release/stable.txt)/bin/windows/amd64/kubectl.exe
```

或者使用 Chocolatey 來安裝：

```bash
choco install kubernetes-cli
```

## 使用方法

kubectl 的詳細使用方法請參考 [kubectl 指南](/kubernetes/concepts/components/kubectl.md)。

## kubectl 插件

你可以使用 krew 來管理 kubectl 插件。

[krew](https://github.com/kubernetes-sigs/krew) 是一個用來管理 kubectl 插件的工具，類似於 apt 或 yum，支持搜索、安裝和管理 kubectl 插件。

### 安裝

```bash
(
  set -x; cd "$(mktemp -d)" &&
  curl -fsSLO "https://storage.googleapis.com/krew/v0.2.1/krew.{tar.gz,yaml}" &&
  tar zxvf krew.tar.gz &&
  ./krew-"$(uname | tr '[:upper:]' '[:lower:]')_amd64" install \
    --manifest=krew.yaml --archive=krew.tar.gz
)
```

安裝完成後，把 krew 的二進制文件加入環境變量 PATH 中：

```bash
export PATH="${KREW_ROOT:-$HOME/.krew}/bin:$PATH"
```

最後，再執行 kubectl 命令確認安裝成功：

```bash
$ kubectl plugin list
The following kubectl-compatible plugins are available:

/home/<user>/.krew/bin/kubectl-krew
```

### 使用方法

首次使用前，請執行下面的命令更新插件索引：

```bash
kubectl krew update
```

使用示例：

```bash
kubectl krew search               # show all plugins
kubectl krew install ssh-jump  # install a plugin named "ssh-jump"
kubectl ssh-jump               # use the plugin
kubectl krew upgrade              # upgrade installed plugins
kubectl krew remove ssh-jump   # uninstall a plugin
```

在安裝插件後，會輸出插件所依賴的外部工具，這些工具需要你自己手動安裝。

```bash
Installing plugin: ssh-jump
CAVEATS:
\
 |  This plugin needs the following programs:
 |  * ssh(1)
 |  * ssh-agent(1)
 |
 |  Please follow the documentation: https://github.com/yokawasa/kubectl-plugin-ssh-jump
/
Installed plugin: ssh-jump
```

最後，就可以通過 `kubectl <plugin-name>` 來使用插件了：

```bash
kubectl ssh-jump <node-name> -u <username> -i ~/.ssh/id_rsa -p ~/.ssh/id_rsa.pub
```

### 升級方法

```bash
kubectl krew upgrade
```

## 參考文檔

* <https://github.com/kubernetes-sigs/krew>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://xu-min-chang.gitbook.io/kubernetes/setup/kubectl.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.