Skip to content

Commit

Permalink
Include Usage and installtion into README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
dgolovin authored May 3, 2024
1 parent 5ba535e commit bbb9017
Showing 1 changed file with 43 additions and 24 deletions.
67 changes: 43 additions & 24 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,54 +5,73 @@ After few simple configuration steps the extension allows you to push an image t

# Usage

Once installed, you can find the Sandbox resource added to the Settings page.
Once installed, you can find the Sandbox resource added to the Resources settings page.

![image]()
![image](https://github.com/dgolovin/podman-desktop-sandbox-ext/assets/620330/66387862-6f1d-4674-a19f-97510021ae15)

To configure kubernetes context for your Sandbox click on 'Create new' button in Sandbox section and open [OpenShift Developer Sandbox](https://developers.redhat.com/developer-sandbox) page by clicking on '' button.
To configure kubernetes context for your Sandbox click on 'Create new ...' button to see Sandbox kubernetes context configuration form.

![image]()
![image](https://github.com/dgolovin/podman-desktop-sandbox-ext/assets/620330/e4094e32-fe84-4743-935e-0ba7b025d8d8)

Follow the description on top of the form to copy a login command from Sandbox Developer Console to `Login command from Developer Console` field. Then set desired kubernetes context name in corresponding field and press `Create` button.

Create your Sandbox instance for free with a few simple steps, launch it and login into Sandbox Developer console. Once you are in, call context menu on your user name in upper right corner and select 'Copy login command' item to show page with login command. Copy login command in red square below.
![image](https://github.com/dgolovin/podman-desktop-sandbox-ext/assets/620330/3435d8c6-d405-4b18-a555-b30d080e30eb)

Switch back to Podman Desktop window and paste command to the '' field
There should be new Sandbox connection in 'running' state in Sandbox section after that.

![image]()
![image](https://github.com/dgolovin/podman-desktop-sandbox-ext/assets/620330/2c9d68bb-c4a4-4dcb-bc34-3abd215d502d)

Fill in '' field and press '' button.
To deploy your first application on OpenShift. Create `Containerfile` shown below

![image]()
```
FROM --platform=linux/amd64 registry.access.redhat.com/ubi8/httpd-24:latest
You will see new Sandbox connection in 'running' state in Sandbox section.
LABEL org.opencontainers.image.title="Simple application with static content" \
org.opencontainers.image.description="This is example of using Apache httpd 2.4 image to deploy web server with static content" \
org.opencontainers.image.vendor="Red Hat"
```

!()[]
Open Podman Desktop 'Build image' page and point `Containerfile path` to Containerfile above. Put `httpd-demo`
in `Image Name` field. Select `Intel and AMD x86_64` in platform section and press 'Build' button to build the image.

You are ready now to deploy your first application on OpenShift.
![image](https://github.com/dgolovin/podman-desktop-sandbox-ext/assets/620330/a77bb9b2-bc70-43d4-885f-bada705acba9)

Pull the '' image using Podman Desktop 'Pull image' page
After build is done pres `Done` button to swithch to `Images` page.

!()[]
![image](https://github.com/dgolovin/podman-desktop-sandbox-ext/assets/620330/3f010889-198f-4863-8957-2e0dc811de6c)

Push it to Sandbox using image context menu
In the Images page find `httpd-demo` image and select item `Push to Developer Sandbox cluster` to tag image with
Sandbox internal registry name and then push tagged image to the registry.

![]()
![image](https://github.com/dgolovin/podman-desktop-sandbox-ext/assets/620330/45a156f7-da99-4891-a617-2443a41e816a)

Start container from the image using '' page
After successfuly pushing the image to internal Sandbox image registry an information message with explanation should apperar.

![]()
![image](https://github.com/dgolovin/podman-desktop-sandbox-ext/assets/620330/1a516a4c-6ce9-4cd2-8108-64a080315c77)

Deploy it to Sandbox cluster using '' page
Close the message and run the image mentioned in it using run button on the right side of the image item.

![]()
![image](https://github.com/dgolovin/podman-desktop-sandbox-ext/assets/620330/692ca1c0-5b9b-4535-a2c7-e5fcdb066be5)

Once pod is up an running click on the link shown below
In `Create Container` leave all default values and press `Start Container` button.

![]()
![image](https://github.com/dgolovin/podman-desktop-sandbox-ext/assets/620330/1d7f9376-d96d-4e44-910c-26b511e156c5)

You application is up an running
After container sucessfully started it can be deployed to kubernetes.

!()[]
![image](https://github.com/dgolovin/podman-desktop-sandbox-ext/assets/620330/2869eda6-10dd-4ef3-90fa-43efa6570ca7)

Make sure current kubernetes context is pointing to Sandbox and press `Deploy` button.

![image](https://github.com/dgolovin/podman-desktop-sandbox-ext/assets/620330/a1d23ad8-5f7b-402e-84aa-1fad78431cd8)

After successful deployment application can be opened in browser.

![image](https://github.com/dgolovin/podman-desktop-sandbox-ext/assets/620330/4f8d0609-69ab-4599-90f3-da7498ec7b49)

The browser window should show default test page for the running HTTPD server.

![image](https://github.com/dgolovin/podman-desktop-sandbox-ext/assets/620330/d2bd5ed5-cc91-4ab1-8528-bb492000b7cd)

# Installation

Expand Down

0 comments on commit bbb9017

Please sign in to comment.