Website • Documentation • Slack
How many times do you copy/paste the names of deployments, pods, services etc. per hour when using kubectl?
DevSpace CLI eliminates these cumbersome, repetitive tasks through automating and streamlining certain workflows. The goal of this project is to accelerate developing, deploying and debugging applications with Docker and Kubernetes.
Containerize any project in minutes
devspace init
- Automatically create a Dockerfile for your app
- Add a highly customizable Helm chart to your project
If you already have a Dockerfile or a Helm chart, DevSpace CLI will ask you if you want to use them instead of the default files.
Customize Dockerfile and Kubernetes deployment:
- Add packages (e.g. databases)
- Configure persistent volumes
- Set environment variables
- Enable auto-scaling
Deploy containerized applications with ease
devspace deploy
- Builds, tags and pushes one or even multiple Docker images
- Creates pull secrets for your image registries
- Deploys your project with the newest images (e.g. using Helm)
DevSpace CLI will use the current kubectl context. If you do not have a Kubernetes cluster, you can use DevSpace Cloud to get a fully managed Kubernetes namespace.
Develop cloud-native software faster then ever
devspace dev
With DevSpace, you can build and test your application directly inside Kubernetes. Thanks to our real-time code sync, you can even use hot reloading tools (e.g. nodemon) to refresh your running application without having to waste time on re-building and re-deploying your application every time you change your code. With DevSpace, your containers are updated in real-time without any delay.
Learn more about development with DevSpace:
- Real-time code synchronization for hot reloading
- Automatic port forwarding for access via localhost
- Terminal proxy for running commands in your containers
Debug deployments without hassle
devspace analyze
DevSpace automatically analyzes your deployments, identifies potential issues and helps you resolve them:
- Identify reasons for image pull failure
- View log snapshots of crashed containers
- Debug networking issues (e.g. misconfigured services)
Learn more about development with DevSpace:
via Windows Powershell
md -Force "$Env:APPDATA\devspace"; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]'Tls,Tls11,Tls12';
wget -UseBasicParsing ((Invoke-WebRequest -URI "https://github.com/devspace-cloud/devspace/releases/latest" -UseBasicParsing).Content -replace "(?ms).*`"([^`"]*devspace-windows-amd64.exe)`".*","https://github.com/`$1") -o $Env:APPDATA\devspace\devspace.exe; & "$Env:APPDATA\devspace\devspace.exe" "install"; $env:Path = (Get-ItemProperty -Path HKCU:\Environment -Name Path).Path
via Mac Terminal
curl -s -L "https://github.com/devspace-cloud/devspace/releases/latest" | sed -nE 's!.*"([^"]*devspace-darwin-amd64)".*!https://github.com\1!p' | xargs -n 1 curl -L -o devspace && chmod +x devspace;
sudo mv devspace /usr/local/bin;
via Linux Bash
curl -s -L "https://github.com/devspace-cloud/devspace/releases/latest" | sed -nE 's!.*"([^"]*devspace-linux-amd64)".*!https://github.com\1!p' | xargs -n 1 curl -L -o devspace && chmod +x devspace;
sudo mv devspace /usr/local/bin;
DevSpace uses Docker to build container images, so you need Docker on your local computer. If you do not have Docker installed yet, you can download the latest stable releases here:
- Mac: Docker Community Edition
- Windows Pro: Docker Community Edition
- Windows 10 Home: Docker Toolbox (legacy)
Run this command within your project:
devspace init
Don't have a project to test DevSpace with? Check out our example project.
git clone https://github.com/devspace-cloud/devspace-quickstart-nodejs
What does devspace init do?
DevSpace CLI will automatically detect your programming language and ask for the ports your application is listening on. It will then create an Helm chart and a Dockerfile within your project, if you do not already have one.
Run this command to create a new namespace and set it as default namespace for the current context:
kubectl create namespace my-app
kubectl config set-context --current --namespace=my-app
DevSpace CLI will, by default, operate in the default namespace of your current context. However, you can also define a namespace in the DevSpace configuration to tell DevSpace CLI that it should always switch to this namespace before running any commands.
Using
--currentin the seconds command requires a fairly recent version of kubectl.
This command will create and configure a Kubernetes namespace for you:
devspace create space my-app
DevSpace Cloud will provide a fully managed Kubernetes namespace for you. You can create one Space for free on DevSpace Cloud. See DevSpace Cloud pricing for further details.
Deploy your application to your newly created Space:
devspace deploy
- Debugging deployments with DevSpace
- Developing applications with DevSpace
- Connecting custom domains (DevSpace Cloud)
Help us make DevSpace CLI the best tool for developing, deploying and debugging Kubernetes apps.
If you find a bug while working with the DevSpace CLI, please open an issue on GitHub and let us know what went wrong. We will try to fix it as quickly as we can.
You are more than welcome to open issues in this project to:
This project is mainly written in Golang. If you want to contribute code:
- Ensure you are running golang version 1.11.4 or greater for go module support
- Set the following environment variables:
GO111MODULE=on GOFLAGS=-mod=vendor - Check-out the project:
git clone https://github.com/devspace-cloud/devspace && cd devspace - Run
go clean -modcache - Run
go mod vendor - Make changes to the code
- Build the project, e.g. via
go build -o devspace.exe - Evaluate and test your changes
./devspace [SOME_COMMAND]
See Contributing Guideslines for more information.
Do I need a Kubernetes cluster to use DevSpace?
No. You can simply use the fully managed Spaces provided by DevSpace Cloud.
Can I use DevSpace with my existing Kubernetes clusters?
Yes. You have two options:
- Connect your existing Kubernetes clusters to DevSpace Cloud as external clusters. DevSpace Cloud will then be able to create and manage users and Spaces on top of your Kubernetes clusters.
- You just use DevSpace CLI without DevSpace Cloud. That means that you manually need to:
- enforce resource limits
- configure secure user permissions
- isolate namespaces of different users
- connect domains and configure ingresses
- install and manage basic cluster services (e.g. ingress controller, cert-manager for TLS, monitoring and log aggregation tools)
Do I need to be a Kubernetes expert to use DevSpace?
No. Altough DevSpace provides a lot of advanced tooling for Kubernetes experts, it is optimized for developer experience which makes it especially easy to use for Kubernetes beginners.
What is a Space?
Spaces are smart Kubernetes namespaces which provide the following features:
- Automatic provisioning via
devspace create space [SPACE_NAME] - Automatic allocation of a subdomain for each Space, e.g.
my-app.devspace.host - Automatic RBAC configuration for better isolation of users
- Automatic resource limit configuration and enforcement
- Resource auto-scaling within the configured limits
- Smart analysis of issues within your Space via
devspace analyze
What is DevSpace CLI?
DevSpace CLI is an open-source command-line tool that provides everything you need to develop, deploy and debug applications with Docker and Kubernetes.
You can either use DevSpace CLI as standalone solution for your self-managed Kubernetes namespaces or in combination with DevSpace Cloud.
What is DevSpace Cloud?
DevSpace Cloud is a developer platform for Kubernetes that lets you create and manage Spaces via DevSpace CLI or GUI.
The Spaces you create with DevSpace Cloud either run on a Kubernetes cluster within DevSpace Cloud or on your own Kubernetes clusters after connecting them to the platform.
What is a Helm chart?
Helm is the package manager for Kubernetes. Packages in Helm are called Helm charts.
You can use the DevSpace CLI for any private or commercial projects because it is licensed under the Apache 2.0 open source license.