GithubHelp home page GithubHelp logo

dritter / devbox Goto Github PK

View Code? Open in Web Editor NEW

This project forked from jetify-com/devbox

0.0 1.0 0.0 3.68 MB

Instant, easy, predictable shells and containers.

Home Page: https://www.jetpack.io/devbox/

License: Apache License 2.0

Go 94.55% TypeScript 5.45%

devbox's Introduction

Devbox logo.

Devbox

Instant, easy, and predictable shells and containers

Join Discord License: Apache 2.0 version tests

What is it?

Devbox is a command-line tool that lets you easily create isolated shells and containers. You start by defining the list of packages required by your development environment, and devbox uses that definition to create an isolated environment just for your application.

In practice, Devbox works similar to a package manager like yarn – except the packages it manages are at the operating-system level (the sort of thing you would normally install with brew or apt-get).

Devbox was originally developed by jetpack.io and is internally powered by nix.

Demo

The example below creates a development environment with python 2.7 and go 1.18, even though those packages are not installed in the underlying machine:

screen cast

Benefits

A consistent shell for everyone on the team

Declare the list of tools needed by your project via a devbox.json file and run devbox shell. Everyone working on the project gets a shell environment with the exact same version of those tools.

Try new tools without polluting your laptop

Development environments created by Devbox are isolated from everything else in your laptop. Is there a tool you want to try without making a mess? Add it to a Devbox shell, and remove it when you don't want it anymore – all while keeping your laptop pristine.

Don't sacrifice speed

Devbox can create isolated environments right on your laptop, without an extra-layer of virtualization slowing your file system or every command. When you're ready to ship, it'll turn it into an equivalent container – but not before.

Good-bye conflicting versions

Are you working on multiple projects, all of which need different versions of the same binary? Instead of attempting to install conflicting versions of the same binary on your laptop, create an isolated environment for each project, and use whatever version you want for each.

Instantly turn your application into a container

Devbox analyzes your source code and instantly turns it into an OCI-compliant image that can be deployed to any cloud. The image is optimized for speed, size, security and caching ... and without needing to write a Dockerfile. And unlike buildpacks, it does it quickly.

Stop declaring dependencies twice

Your application often needs the same set of dependencies when you are developing on your laptop, and when you're packaging it as a container ready to deploy to the cloud. Devbox's dev environments are isomorphic: meaning that we can turn them into both a local shell environment or a cloud-ready container, all without having to repeat yourself twice.

Installing Devbox

In addition to installing Devbox itself, you will need to install nix and docker since Devbox depends on them:

  1. Install Nix Package Manager. (Don't worry, you don't need to learn Nix.)

  2. Install Docker Engine or Docker Desktop. Note that docker is only needed if you want to create containers – the shell functionality works without it.

  3. Install Devbox:

    curl -fsSL https://get.jetpack.io/devbox | bash

Read more on the Devbox docs.

Quickstart: Fast, Deterministic Shell

In this quickstart we’ll create a development shell with specific tools installed. These tools will only be available when using this Devbox shell, ensuring we don’t pollute your machine.

  1. Open a terminal in a new empty folder.

  2. Initialize Devbox:

    devbox init

    This creates a devbox.json file in the current directory. You should commit it to source control.

  3. Add command-line tools from Nix Packages. For example, to add Python 3.10:

    devbox add python310
  4. Your devbox.json file keeps track of the packages you've added, it should now look like this:

    {
       "packages": [
          "python310"
        ]
    }
  5. Start a new shell that has these tools installed:

    devbox shell

    You can tell you’re in a Devbox shell (and not your regular terminal) because the shell prompt changed.

  6. Use your favorite tools.

    In this example we installed Python 3.10, so let’s use it.

    python --version
  7. Your regular tools are also available including environment variables and config settings.

    git config --get user.name
  8. To exit the Devbox shell and return to your regular shell:

    exit

Read more on the Devbox docs Quickstart.

Quickstart: Instant Docker Image

Devbox makes it easy to package your application into an OCI-compliant container image. Devbox analyzes your code, automatically identifies the right toolchain needed by your project, and builds it into a docker image.

  1. Initialize your project with devbox init if you haven't already.

  2. Build the image:

    devbox build

    The resulting image is named devbox.

  3. Tag the image with a more descriptive name:

    docker tag devbox my-image:v0.1

Auto-detected languages/stacks

Devbox currently detects the following languages/stacks:

Want more languages? Ask for a new Language or contribute one via a Pull Request. Read more on the Devbox docs Quickstart.

Additional commands

devbox help - see all commands

devbox plan - see the configuration and steps Devbox will use to generate a container

See the CLI Reference for the full list of commands.

Join our Developer Community

Contributing

Devbox is an opensource project so contributions are always welcome. Please read our contributing guide before submitting pull requests.

Related Work

Thanks to Nix for providing isolated shells.

Translation

License

This project is proudly open-source under the Apache 2.0 License

devbox's People

Contributors

dependabot[bot] avatar gcurtis avatar ipince avatar lagoja avatar loreto avatar lucilleh avatar mikeland73 avatar mohsenari avatar reflektoin avatar robrich avatar savil avatar yeegsing avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.