105 lines
5.7 KiB
Markdown
105 lines
5.7 KiB
Markdown
|
|
# What is Kubectl?
|
|
|
|
> Kubectl is the Kubernetes command line interface.
|
|
|
|
[Overview of kubectl](https://kubernetes.io/docs/reference/kubectl/overview/)
|
|
|
|
# TL;DR;
|
|
|
|
```bash
|
|
$ docker run --name kubectl bitnami/kubectl:latest
|
|
```
|
|
|
|
# Why use Bitnami Images?
|
|
|
|
* Bitnami closely tracks upstream source changes and promptly publishes new versions of this image using our automated systems.
|
|
* With Bitnami images the latest bug fixes and features are available as soon as possible.
|
|
* Bitnami containers, virtual machines and cloud images use the same components and configuration approach - making it easy to switch between formats based on your project needs.
|
|
* All our images are based on [minideb](https://github.com/bitnami/minideb) a minimalist Debian based container image which gives you a small base container image and the familiarity of a leading linux distribution.
|
|
* Bitnami container images are released daily with the latest distribution packages available.
|
|
|
|
[](https://anchore.io/image/dockerhub/bitnami%2Fkubectl%3Alatest#security)
|
|
|
|
> The image overview badge contains a security report with all open CVEs. Click on 'Show only CVEs with fixes' to get the list of actionable security issues.
|
|
|
|
# Supported tags and respective `Dockerfile` links
|
|
|
|
Learn more about the Bitnami tagging policy and the difference between rolling tags and immutable tags [in our documentation page](https://docs.bitnami.com/containers/how-to/understand-rolling-tags-containers/).
|
|
|
|
|
|
* [`1.13-ol-7`, `1.13.1-ol-7-r2` (1.13/ol-7/Dockerfile)](https://github.com/bitnami/bitnami-docker-kubectl/blob/1.13.1-ol-7-r2/1.13/ol-7/Dockerfile)
|
|
* [`1.13-debian-9`, `1.13.1-debian-9-r2`, `1.13`, `1.13.1`, `1.13.1-r2`, `latest` (1.13/debian-9/Dockerfile)](https://github.com/bitnami/bitnami-docker-kubectl/blob/1.13.1-debian-9-r2/1.13/debian-9/Dockerfile)
|
|
* [`1.12-ol-7`, `1.12.4-ol-7-r3` (1.12/ol-7/Dockerfile)](https://github.com/bitnami/bitnami-docker-kubectl/blob/1.12.4-ol-7-r3/1.12/ol-7/Dockerfile)
|
|
* [`1.12-debian-9`, `1.12.4-debian-9-r2`, `1.12`, `1.12.4`, `1.12.4-r2` (1.12/debian-9/Dockerfile)](https://github.com/bitnami/bitnami-docker-kubectl/blob/1.12.4-debian-9-r2/1.12/debian-9/Dockerfile)
|
|
* [`1.11-ol-7`, `1.11.6-ol-7-r2` (1.11/ol-7/Dockerfile)](https://github.com/bitnami/bitnami-docker-kubectl/blob/1.11.6-ol-7-r2/1.11/ol-7/Dockerfile)
|
|
* [`1.11-debian-9`, `1.11.6-debian-9-r2`, `1.11`, `1.11.6`, `1.11.6-r2` (1.11/debian-9/Dockerfile)](https://github.com/bitnami/bitnami-docker-kubectl/blob/1.11.6-debian-9-r2/1.11/debian-9/Dockerfile)
|
|
* [`1.10-ol-7`, `1.10.12-ol-7-r1` (1.10/ol-7/Dockerfile)](https://github.com/bitnami/bitnami-docker-kubectl/blob/1.10.12-ol-7-r1/1.10/ol-7/Dockerfile)
|
|
* [`1.10-debian-9`, `1.10.12-debian-9-r0`, `1.10`, `1.10.12`, `1.10.12-r0` (1.10/debian-9/Dockerfile)](https://github.com/bitnami/bitnami-docker-kubectl/blob/1.10.12-debian-9-r0/1.10/debian-9/Dockerfile)
|
|
* [`1.9-ol-7`, `1.9.11-ol-7-r2` (1.9/ol-7/Dockerfile)](https://github.com/bitnami/bitnami-docker-kubectl/blob/1.9.11-ol-7-r2/1.9/ol-7/Dockerfile)
|
|
* [`1.9-debian-9`, `1.9.11-debian-9-r2`, `1.9`, `1.9.11`, `1.9.11-r2` (1.9/debian-9/Dockerfile)](https://github.com/bitnami/bitnami-docker-kubectl/blob/1.9.11-debian-9-r2/1.9/debian-9/Dockerfile)
|
|
|
|
Subscribe to project updates by watching the [bitnami/kubectl GitHub repo](https://github.com/bitnami/bitnami-docker-kubectl).
|
|
|
|
# Get this image
|
|
|
|
The recommended way to get the Bitnami Kubectl Docker Image is to pull the prebuilt image from the [Docker Hub Registry](https://hub.docker.com/r/bitnami/kubectl).
|
|
|
|
```bash
|
|
$ docker pull bitnami/kubectl:latest
|
|
```
|
|
|
|
To use a specific version, you can pull a versioned tag. You can view the [list of available versions](https://hub.docker.com/r/bitnami/kubectl/tags/) in the Docker Hub Registry.
|
|
|
|
```bash
|
|
$ docker pull bitnami/kubectl:[TAG]
|
|
```
|
|
|
|
If you wish, you can also build the image yourself.
|
|
|
|
```bash
|
|
$ docker build -t bitnami/kubectl:latest https://github.com/bitnami/bitnami-docker-kubectl.git
|
|
```
|
|
|
|
# Configuration
|
|
|
|
## Running commands
|
|
|
|
To run commands inside this container you can use `docker run`, for example to execute `kubectl --version` you can follow the example below:
|
|
|
|
```bash
|
|
$ docker run --rm --name kubectl bitnami/kubectl:latest -- --version
|
|
```
|
|
|
|
Consult the [Kubectl Reference Documentation](https://kubernetes.io/docs/reference/generated/kubectl/kubectl-commands) to find the completed list of commands available.
|
|
|
|
# Contributing
|
|
|
|
We'd love for you to contribute to this container. You can request new features by creating an [issue](https://github.com/bitnami/bitnami-docker-kubectl/issues), or submit a [pull request](https://github.com/bitnami/bitnami-docker-kubectl/pulls) with your contribution.
|
|
|
|
# Issues
|
|
|
|
If you encountered a problem running this container, you can file an [issue](https://github.com/bitnami/bitnami-docker-kubectl/issues). For us to provide better support, be sure to include the following information in your issue:
|
|
|
|
- Host OS and version
|
|
- Docker version (`docker version`)
|
|
- Output of `docker info`
|
|
- Version of this container
|
|
- The command you used to run the container, and any relevant output you saw (masking any sensitive information)
|
|
|
|
# License
|
|
|
|
Copyright 2018 Bitnami
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License");
|
|
you may not use this file except in compliance with the License.
|
|
You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
See the License for the specific language governing permissions and
|
|
limitations under the License.
|