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

feat: Use docker or podman to start a local container #603

Merged
merged 1 commit into from
Oct 14, 2021
Merged

feat: Use docker or podman to start a local container #603

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
88 changes: 64 additions & 24 deletions docs/installation/web-interface.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,39 +10,79 @@ nav_order: 2

## Bringing up Move2Kube all-in-one container

**Stable Release**
```console
$ mkdir -p workspace
$ cd workspace
$ docker run -p 8080:8080 -v "${PWD}:/workspace" -v /var/run/docker.sock:/var/run/docker.sock --rm -it quay.io/konveyor/move2kube-aio:release-0.2
```

**Latest**
```console
$ mkdir -p workspace
$ cd workspace
$ docker run -p 8080:8080 -v "${PWD}:/workspace" -v /var/run/docker.sock:/var/run/docker.sock --rm -it quay.io/konveyor/move2kube-aio:latest
```
Access the UI in `http://localhost:8080/`.
Choose the version ready for you use case:

**Stable Release** ready for production cases:

To run locally using `docker`:

```shell
$ mkdir -p workspace
$ cd workspace
$ docker run -p 8080:8080 -v "${PWD}:/workspace" -v /var/run/docker.sock:/var/run/docker.sock --rm -it quay.io/konveyor/move2kube-aio:release-0.2
```

To run locally using `podman`:

```shell
$ mkdir -p workspace
$ cd workspace
$ podman run -p 8080:8080 -v "${PWD}:/workspace:z" --rm -it quay.io/konveyor/move2kube-aio:release-0.2
```

**Latest** for development and testing cases:

To run locally using `docker`:

```shell
$ mkdir -p workspace
$ cd workspace
$ docker run -p 8080:8080 -v "${PWD}:/workspace" -v /var/run/docker.sock:/var/run/docker.sock --rm -it quay.io/konveyor/move2kube-aio:latest
```

To run locally using `podman`:

```shell
$ mkdir -p workspace
$ cd workspace
$ podman run -p 8080:8080 -v "${PWD}:/workspace:z" --rm -it quay.io/konveyor/move2kube-aio:latest
```

Access the UI in `http://localhost:8080/`.

> Note: There is a known issue when using the above command in WSL.
The CNB containerization option will not be availabe.
The CNB containerization option will not be available.
Also an empty folder called `workspace` may be created in the root directory.
If you are on Windows, use Powershell instead of WSL until this is fixed.

## Bringing up Move2Kube UI and API as separate containers

```console
$ git clone https://github.com/konveyor/move2kube-ui
$ cd move2kube-ui
$ docker-compose up
```
Access the UI in `http://localhost:8080/`.
Cloning the git repository:

```shell
$ git clone https://github.com/konveyor/move2kube-ui
$ cd move2kube-ui
$ mkdir -p data
```

The `data` folder will be used to persist the data managed by the container.

Start the container using `docker-compose`:

```shell
$ docker-compose up
```

Or using `podman-compose`:

```shell
$ podman-compose -f podman-compose.yml up
```

Access the UI in `http://localhost:8080/`.

## Bringing up Move2Kube UI as Helm Chart
Move2Kube can also be installed as a Helm Chart from [ArtifactHub](https://artifacthub.io/packages/helm/move2kube/move2kube/0.2.0-beta.0?modal=install)

Also, for Helm Chart and Operator checkout [Move2Kube Operator](https://github.com/konveyor/move2kube-operator).
Move2Kube can also be installed as a Helm Chart from [ArtifactHub](https://artifacthub.io/packages/helm/move2kube/move2kube/0.2.0-beta.0?modal=install)

<br>
Also, for Helm Chart and Operator checkout [Move2Kube Operator](https://github.com/konveyor/move2kube-operator).