Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Format the auto-generate list(catalog) and update the render style #9069

Merged
merged 2 commits into from
Jul 17, 2018
Merged

Format the auto-generate list(catalog) and update the render style #9069

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
ee349cb
Format the auto-generate list(catalog) and update the render style
angao Jun 14, 2018
5699e54
Merge branch 'master' into fmt-tck
angao Jul 17, 2018
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
34 changes: 20 additions & 14 deletions content/en/docs/tasks/configure-pod-container/translate-compose-kubernetes.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ More information can be found on the Kompose website at [http://kompose.io](http

We have multiple ways to install Kompose. Our preferred method is downloading the binary from the latest GitHub release.

### GitHub release
## GitHub release

Kompose is released via GitHub on a three-week cycle, you can see all current releases on the [GitHub release page](https://github.com/kubernetes/kompose/releases).

Expand All @@ -48,15 +48,15 @@ sudo mv ./kompose /usr/local/bin/kompose

Alternatively, you can download the [tarball](https://github.com/kubernetes/kompose/releases).

### Go
## Go

Installing using `go get` pulls from the master branch with the latest development changes.

```sh
go get -u github.com/kubernetes/kompose
```

### CentOS
## CentOS

Kompose is in [EPEL](https://fedoraproject.org/wiki/EPEL) CentOS repository.
If you don't have [EPEL](https://fedoraproject.org/wiki/EPEL) repository already installed and enabled you can do it by running `sudo yum install epel-release`
Expand All @@ -67,14 +67,16 @@ If you have [EPEL](https://fedoraproject.org/wiki/EPEL) enabled in your system,
sudo yum -y install kompose
```

### Fedora
## Fedora

Kompose is in Fedora 24, 25 and 26 repositories. You can install it just like any other package.

```bash
sudo dnf -y install kompose
```

### macOS
## macOS

On macOS you can install latest release via [Homebrew](https://brew.sh):

```bash
Expand Down Expand Up @@ -334,9 +336,10 @@ po/frontend-2768218532-cs5t5 1/1 Running 0 4m
po/redis-master-1432129712-63jn8 1/1 Running 0 4m
po/redis-slave-2504961300-nve7b 1/1 Running 0 4m
```
Note:
**Note**:

- You must have a running Kubernetes cluster with a pre-configured kubectl context.
- Only deployments and services are generated and deployed to Kubernetes. If you need different kind of resources, use the 'kompose convert' and 'kubectl create -f' commands instead.
- Only deployments and services are generated and deployed to Kubernetes. If you need different kind of resources, use the `kompose convert` and `kubectl create -f` commands instead.

### OpenShift
```sh
Expand Down Expand Up @@ -371,7 +374,8 @@ is/redis-master 172.30.12.200:5000/fff/redis-master
is/redis-slave 172.30.12.200:5000/fff/redis-slave v1
```

Note:
**Note**:

- You must have a running OpenShift cluster with a pre-configured `oc` context (`oc login`)

## `kompose down`
Expand All @@ -387,7 +391,9 @@ INFO Successfully deleted deployment: redis-slave
INFO Successfully deleted service: frontend
INFO Successfully deleted deployment: frontend
```
Note:

**Note**:

- You must have a running Kubernetes cluster with a pre-configured kubectl context.

## Build and Push Docker Images
Expand Down Expand Up @@ -497,7 +503,7 @@ The chart structure is aimed at providing a skeleton for building your Helm char

`kompose` supports Kompose-specific labels within the `docker-compose.yml` file in order to explicitly define a service's behavior upon conversion.

- kompose.service.type defines the type of service to be created.
- `kompose.service.type` defines the type of service to be created.

For example:

Expand All @@ -515,9 +521,9 @@ services:
kompose.service.type: nodeport
```

- kompose.service.expose defines if the service needs to be made accessible from outside the cluster or not. If the value is set to "true", the provider sets the endpoint automatically, and for any other value, the value is set as the hostname. If multiple ports are defined in a service, the first one is chosen to be the exposed.
- For the Kubernetes provider, an ingress resource is created and it is assumed that an ingress controller has already been configured.
- For the OpenShift provider, a route is created.
- `kompose.service.expose` defines if the service needs to be made accessible from outside the cluster or not. If the value is set to "true", the provider sets the endpoint automatically, and for any other value, the value is set as the hostname. If multiple ports are defined in a service, the first one is chosen to be the exposed.
- For the Kubernetes provider, an ingress resource is created and it is assumed that an ingress controller has already been configured.
- For the OpenShift provider, a route is created.

For example:

Expand Down Expand Up @@ -572,7 +578,7 @@ services:
restart: "on-failure"
```

#### Warning about Deployment Config's
### Warning about Deployment Config's

If the Docker Compose file has a volume specified for a service, the Deployment (Kubernetes) or DeploymentConfig (OpenShift) strategy is changed to "Recreate" instead of "RollingUpdate" (default). This is done to avoid multiple instances of a service from accessing a volume at the same time.

Expand Down