Challenge, Easy,  on  Kubernetes

Copy a File into a Running Pod to Serve a Custom NGINX Page

Scenario

A Pod named blackhole-3d is running in the space namespace using the nginx image. The Pod is already exposed via a NodePort Service on port 30088.

On the dev-machine, there is a file located at:

/home/laborant/blackhole/index.html

This file contains a simple 3D view of a black hole and must be served by the NGINX container as the default homepage.

Task

Copy the file from the dev-machine into the running Pod so that NGINX serves it as the default page.

  • Place the file in the correct directory used by NGINX to serve default content
  • View the simple 3D black hole page in the Blackhole-3D tab. If you still do not see the 3D black hole in the tab, refresh the Playground web page.

Do not create or modify any Pods or Services. Use imperative commands only.

Hint 1

NGINX serves files from /usr/share/nginx/html/ by default. The default homepage must be named index.html and placed in that directory. Use kubectl cp to copy files into a running Pod without modifying it.

Use kubectl cp to copy a file from the local machine into a running Pod. The syntax is kubectl cp <local-path> <namespace>/<pod-name>:<container-path>.

See the official docs: kubectl cp

Test Cases

How to Author Challenges on iximiuz Labs

Instead of providing a subpar online editing experience, iximiuz Labs offers a helper CLI tool called labctl, allowing you to use your favorite text editor (or a full-featured IDE) to write content from the comfort of your local machine.

Install labctl CLI

curl -sf https://labs.iximiuz.com/cli/install.sh | sh

This will download and install the latest version of the labctl CLI. You only need to do this once per workstation.

Authorize labctl

labctl auth login

This will open a browser window asking you to authorize labctl to access your account. You need to do it after a fresh install of labctl and repeat it whenever the auth session expires.

Pull challenge content

labctl content pull challenge copy-file-to-running-pod-603cfc9c

This will create a local copy of the challenge content in a directory named copy-file-to-running-pod-603cfc9c. You only need to do this once per challenge.

Stream your changes

labctl content push -fw challenge copy-file-to-running-pod-603cfc9c

Run this command in a separate terminal to continuously upload your changes to the server while editing the challenge in your favorite text editor or IDE.

You can also use labctl to create, list, and delete your content. Learn more about the available commands: labctl content --help

Start challenge