Replace docker with podman #19

pacostas · 2022-08-16T11:07:58Z

My status on PR

This commit updates the cloud-native tutorial to use Podman instead of Docker/Docker Desktop.

mhdawson · 2022-08-31T20:20:56Z

cloud-native/README.md

+```
+We can now build the image directly using `minikube image build`:
+```console
+$ minikube image build -t $(minikube ip):42631/nodeserver:1.0.0 --file Dockerfile-run .


This did not work for me in a Windows cmd shell.

I had to do the following which did work:
C:\Users\midawson\workshop\tutorial\nodeserver>minikube ip
172.26.219.253

C:\Users\midawson\workshop\tutorial\nodeserver> minikube image build -t 172.26.219.253:42631/nodeserver:1.0.0 --file Dockerfile-run .

It also took quite a while to run without output so might be worth mentioning that.

I'll investigate tomorrow a bit more. Also I'll check if we can do pull/push etc. using the podman Desktop registry UI.

mhdawson · 2022-08-31T20:27:18Z

cloud-native/README.md

+```
+Next, we push the image into the registry using:
+```console
+$ minikube image push $(minikube ip):42631/nodeserver


I used the IP isntead of $(minikube ip) here as well

mhdawson · 2022-08-31T20:31:01Z

cloud-native/README.md

@@ -448,7 +445,7 @@ Kubernetes has a concept of a 'Service', which is an abstract way to expose an a
 3. You can forward the `nodeserver-service` to your device by:

  ```sh
-  kubectl port-forward service/nodeserver-service 3000
+  minikube kubectl -- port-forward service/nodeserver-service 3000
  ```

 You can now access the application endpoints from your browser.


It would be handy to add the links to the app, metrics and health endpoints again here, just like in the other sections.

cloud-native/README.md

mhdawson · 2022-08-31T20:38:06Z

cloud-native/README.md

-  export POD_NAME=$(kubectl get pods --namespace grafana -o jsonpath="{.items[0].metadata.name}")
-  kubectl --namespace grafana port-forward $POD_NAME 3001:3000
+  export POD_NAME=$(minikube kubectl -- get pods --namespace grafana -o jsonpath="{.items[0].metadata.name}")
+  minikube kubectl -- --namespace grafana port-forward $POD_NAME 3001:3000


In the On Windows section the corresponding change is missing.
minikube needs to be added in front of kubectl in both lines

minikube needs to be changed to minikube kubectl --

The same is true right at the end where is says kubectl config set-context --current --namespace=default kubectl needs to be changed to minikube kubectl --

mhdawson · 2022-08-31T21:08:16Z

cloud-native/README.md

-Install docker compose
+1. Select the Docker icon in the Menu Bar
+2. Click `Preferences/Settings > Kubernetes > Enable Kubernetes`.


This should not refer to docker anymore right?
should likely be

podman machine init --cpus 4 --memory 8096 --disk-size 50
podman machine start
podman system connection default podman-machine-default-root
minikube start --driver=podman --container-runtime=cri-o

(with podman machine stop, podman machine rm first if the machine is already created

I found other instructions which said

podman machine init --cpus 2 --memory 2048 --disk-size 20
podman machine start
podman system connection default podman-machine-default-root
podman info

so using less memory/cpus may make sense, I used the larger numbers but we should try the smaller ones.

This is the mac flow.

mhdawson · 2022-08-31T21:12:14Z

cloud-native/README.md

+Using [Chocolatey](https://docs.chocolatey.org/en-us/choco/setup#install-with-powershell.exe) Package Manager

-#### `microk8s`
+1. Install minikube with Chocolatey Package manager by using this command in PowerShell

-<details>
+   ```
+   choco install minikube
+   ```

-```sh
-snap install --channel 1.14/stable microk8s --classic
-sudo usermod -a -G microk8s ibmuser
-sudo microk8s.start
-sudo snap alias microk8s.kubectl kubectl
-export PATH=/snap/bin:$PATH
-sudo microk8s.config >~/.kube/config
-microk8s.enable dns registry
-```
+2. Start minikube


Suggested change

Using [Chocolatey](https://docs.chocolatey.org/en-us/choco/setup#install-with-powershell.exe) Package Manager

#### `microk8s`

1. Install minikube with Chocolatey Package manager by using this command in PowerShell

<details>

```

choco install minikube

```

```sh

snap install --channel 1.14/stable microk8s --classic

sudo usermod -a -G microk8s ibmuser

sudo microk8s.start

sudo snap alias microk8s.kubectl kubectl

export PATH=/snap/bin:$PATH

sudo microk8s.config >~/.kube/config

microk8s.enable dns registry

```

2. Start minikube

1. Start minikube

I think minikube installation is covered in other sections.

We have it as a prerequisite at the start of the document, we dont cover the installation process. In case of adding it, should we go with the binary/PATH method or with a package manager? The only drawback I see with the binary/PATH method is that the developers are not that much familiar otherwise in terms of time and steps its the same.

commit reference 637936c

cloud-native/README.md

mhdawson · 2022-08-31T21:23:11Z

Had a few specific comments but overall on Windows seemed to flow ok.

Three things we should think about for follow on PRs

can we easily alias minikube kubectl -- to kubectl on all platforms. If so we may want to do that to make most of the instructions more kubernetes generic.
Should we add a registry to podman instead of using $ minikube image push $(minikube ip):42631/nodeserver, again that might be more kubenetes generic.
If 1 and 2) work out then I wonder if we could have 2 options. 1 to install minikube and 1 to use the RH sandbox. If the rest of the instructions just used kubectl then there might not be any other differences in the instructions other than how you set up kubectl (aliast for minikube or alias to oc for sandbox) and the registry set up for podman (registry in minikube or your registry in sandbox)

mhdawson · 2022-08-31T21:24:43Z

One other thing is that at least on windows it does require admin access to install the pieces needed (podman which requires both hyperv and wsl). I think we better try to get a message to participants in advance with the warning that admin access is needed, and that they should if at all possible install X,Y,Z in advance depending on the platform

mhdawson · 2022-08-31T22:05:54Z

One more, do we even need podman desktop? I don't think we use or mention it in the workshop (although we might want to change that). I wondered about that as the installation instructions don't include the link for Mac, although it is available.

pacostas · 2022-09-01T17:36:01Z

cloud-native/README.md

@@ -337,6 +338,52 @@ You have now built a container image for your application called `nodeserver` wi

 This runs your container image in a Podman container, mapping port 3000 from the container to port 3000 on your laptop so that you can access the application.

+#### On Windows


I had locally and forgot to push:

Instructions for windows users with images for using podman desktop for building and running container images.

pacostas force-pushed the podman branch from c99dd1c to d7d4e92 Compare August 16, 2022 11:09

Replace Docker with Podman in cloud-native

4283c51

This commit updates the cloud-native tutorial to use Podman instead of Docker/Docker Desktop.

pacostas force-pushed the podman branch from d7d4e92 to 20023b4 Compare August 16, 2022 15:50

adding minikube and helm installation

011dc5d

pacostas force-pushed the podman branch from 20023b4 to 011dc5d Compare August 16, 2022 15:59

danbev mentioned this pull request Aug 17, 2022

Replace Docker with Podman in cloud-native #18

Closed

pacostas added 2 commits August 17, 2022 20:05

windows flow installing minikube

c068650

podman desktop on windows

e975fbc

mhdawson marked this pull request as ready for review August 31, 2022 20:17

mhdawson reviewed Aug 31, 2022

View reviewed changes

cloud-native/README.md Show resolved Hide resolved

mhdawson reviewed Aug 31, 2022

View reviewed changes

cloud-native/README.md Outdated Show resolved Hide resolved

pacostas force-pushed the podman branch from 9f29fee to f5ecade Compare September 1, 2022 14:24

pacostas added 2 commits September 1, 2022 18:16

fix: updating helm instructions

3e56f15

refactor: podman installation on windows

7e04c70

pacostas force-pushed the podman branch 2 times, most recently from 3bcc08d to 637936c Compare September 1, 2022 15:21

fix: installing minikube on winodws flow

55b8d1f

pacostas force-pushed the podman branch from 637936c to 55b8d1f Compare September 1, 2022 16:09

pacostas added 2 commits September 1, 2022 20:24

adding podman desktop for building and running container image

6630242

fix: instruction for downloading helm files

9164d5c

pacostas commented Sep 1, 2022

View reviewed changes

mhdawson merged commit 790f22b into nodeshift:main Sep 1, 2022

This was referenced Sep 2, 2022

windows admin access #22

Closed

One more, do we even need Podman Desktop? #23

Closed

Windows flow - 3 comments #24

Closed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Replace docker with podman #19

Replace docker with podman #19

pacostas commented Aug 16, 2022

mhdawson Aug 31, 2022

pacostas Sep 1, 2022

mhdawson Aug 31, 2022

mhdawson Aug 31, 2022

mhdawson Aug 31, 2022 •

edited

mhdawson Aug 31, 2022

mhdawson Aug 31, 2022 •

edited

mhdawson Aug 31, 2022

pacostas Sep 1, 2022

mhdawson Aug 31, 2022 •

edited

pacostas Sep 1, 2022

pacostas Sep 1, 2022

mhdawson commented Aug 31, 2022 •

edited

mhdawson commented Aug 31, 2022

mhdawson commented Aug 31, 2022 •

edited

pacostas Sep 1, 2022

		@@ -337,6 +338,52 @@ You have now built a container image for your application called `nodeserver` wi

		This runs your container image in a Podman container, mapping port 3000 from the container to port 3000 on your laptop so that you can access the application.

		#### On Windows

Replace docker with podman #19

Replace docker with podman #19

Conversation

pacostas commented Aug 16, 2022

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

mhdawson Aug 31, 2022 • edited

Choose a reason for hiding this comment

Choose a reason for hiding this comment

mhdawson Aug 31, 2022 • edited

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

mhdawson Aug 31, 2022 • edited

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

mhdawson commented Aug 31, 2022 • edited

mhdawson commented Aug 31, 2022

mhdawson commented Aug 31, 2022 • edited

Choose a reason for hiding this comment

mhdawson Aug 31, 2022 •

edited

mhdawson Aug 31, 2022 •

edited

mhdawson Aug 31, 2022 •

edited

mhdawson commented Aug 31, 2022 •

edited

mhdawson commented Aug 31, 2022 •

edited