Skip to content

Update READMEs of examples - #244

Draft
procub3r wants to merge 4 commits into
unikraft-cloud:mainfrom
procub3r:main
Draft

Update READMEs of examples#244
procub3r wants to merge 4 commits into
unikraft-cloud:mainfrom
procub3r:main

Conversation

@procub3r

@procub3r procub3r commented Dec 26, 2025

Copy link
Copy Markdown
Contributor

Updating the READMEs of examples to be more accurate.

Signed-off-by: Sriprad Potukuchi <sripradp@proton.me>
Signed-off-by: Sriprad Potukuchi <sripradp@proton.me>
@procub3r procub3r changed the title fix(redis): Create tunnel to correct instance Update READMEs of examples Jan 6, 2026
Signed-off-by: Sriprad Potukuchi <sripradp@proton.me>
…er READMEs

Signed-off-by: Sriprad Potukuchi <sripradp@proton.me>

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates example READMEs to better reflect current Unikraft Cloud deployment steps and example structure, improving the accuracy of instructions users follow when running these examples.

Changes:

  • Expanded the Express (Node 21) example README into a step-by-step deploy + customization guide.
  • Adjusted the Debian SSH example deploy command to explicitly expose the SSH port with TLS routing.
  • Corrected the Redis example directory path and updated the testing instructions to use a TLS-capable tunnel command.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 6 comments.

File Description
expressjs4.18-node21/README.md Reworked into a detailed deploy/customization walkthrough for the Express example.
debian-ssh/README.md Updates the deploy command to include explicit port mapping for SSH exposure.
database-redis7.2/README.md Fixes the example directory path and adjusts testing flow for TLS access.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.


## Learn more

- [Express's Documentation](https://expressjs.com/en/5x/api.html)

* `Kraftfile`: the Unikraft Cloud specification
* `Dockerfile`: the Docker-specified app filesystem
* `app/index.js`: the Express server program
In this case, the instance name is `node21-expressjs-c34b9` and the address is `https://holy-silence-vr9fp0zt.fra.unikraft.app`.
They're different for each run.

Use `curl` to query the Unikraft Cloud instance of the Express:
Comment on lines 9 to +13
2. Clone the [`examples` repository](https://github.com/unikraft-cloud/examples) and `cd` into the `examples/redis/` directory:

```bash
git clone https://github.com/unikraft-cloud/examples
cd examples/redis/
cd examples/database-redis7.2/
In this case, the instance name is `redis-alb4r` and the address is `rough-wind-8vxrd1ms.fra.unikraft.app`. They are different for every run.

To test the deployment, first forward the port with the `kraft cloud tunnel` command:
To test the deployment, first setup a tunnel that handles a TLS connection to the `redis-alb4r` instance:

```bash
kraft cloud tunnel 6379:memcached-arkv7:6379
socat TCP-LISTEN:6379,reuseaddr,fork OPENSSL:rough-wind-8vxrd1ms.fra.unikraft.app:6379,verify=0
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants