devpod 0.2.0

No project description provided

DevPod: Rootless, FOSS .DevContainer Tooling

A support framework for using .devcontainer on Linux desktops. Let's start with Buildah + Podman + Builder, but the project is open to contributions for other IDE integrations.

Basic Setup and Usage

Setup

These instructions should work out of the box on Fedora Silverblue 33+.

1. Install GNOME Builder (example uses Flatpak, but a normal package works, too):

   flatpak install flathub org.gnome.Builder
   

2. Install this utility (choosing an alternative to pip like pipx if you like):

   pip install devpod
   

Usage

1. In the CLI, change to the parent directory of .devcontainer for your project.

2. Run the utility (which will delete any container with the same name as your project directory):

   devpod launch
   

3. The launch command should list any open ports at the end of the process, but you can also list them using Podman directly:

   podman port --latest
   

4. Connect using a Web browser. For example, if the output of port is 80/tcp -> 0.0.0.0:12345, then open a browser to http://localhost:12345/.

Developing DevPod Itself

Installing the CLI Tool from Local Builds

These instructions have been tested on Fedora Silverblue 33 but are probably adaptable to other setups.

1. Install Python package tooling (using a Toolbox if desired):

   sudo dnf install poetry pipx
   

2. Clone the DevPod code and make it your working directory.

3. Build and (re)install the utility for global use:

   rm -rf dist/ && poetry build && pipx install --force dist/devpod-*.tar.gz
   

4. The devpod command should now be globally available to your user, even outside of any Toolbox.

Resources

• .devcontainer Reference Documentation
• Podman Commands Documentation
• Rootless Podman
  • Shortcomings of Rootless Podman
  • Volumes and Rootless Podman
  • User Namespaces, SELinux, and Rootless Containers