Skip to main content

No project description provided

Project description

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.

Example Project

This example assumes a working Podman installation, which exists out of the box on Fedora Silverblue but is also available on many distributions and platforms.

  1. Install this utility:

    pip install devpod
    
  2. Clone Microsoft's PHP sample repository and make it the working directory:

    git clone https://github.com/microsoft/vscode-remote-try-php.git
    cd vscode-remote-try-php/
    
  3. In .devcontainer/devcontainer.json, uncomment the postCreateCommand directive and ensure there's a comma at the end of the line if not yet fixed.

    Uncomment postCreateCommand

  4. Build the container and launch:

    devpod run --launch
    

    Building and launching the container

  5. Edit index.php in your IDE and reload the page in your Browser to see changes.

    Showing index.php in the IDE Showing index.php in the browser

Basic Setup and Usage

Setup

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

  1. 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 run --launch  # Will open a browser to forwarded ports.
    

Troubleshooting

  • 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
    

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

devpod-0.3.0.tar.gz (5.1 kB view hashes)

Uploaded Source

Built Distribution

devpod-0.3.0-py3-none-any.whl (5.6 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page