devspace: A Go repository from KaelBaldwin

Website • Documentation • Slack

Do you like DevSpace CLI? Support the project with a star ⭐️

Automate development and deployment workflows for your entire team

1. Create deployment and development workflows for Kubernetes within minutes

Based on your existing Dockerfile(s) or images from any Docker registry
Based on your existing Kubernetes manifest(s)
Based on your existing Helm chart(s)

2. Share your workflows via git and let anyone on your team:

Deploy to Kubernetes based on your deployment configuration by running a single command: devspace deploy
- Automatic image building (using Docker for local image building or kaniko for in-cluster image building)
- Automatic image tagging, pushing (to any public or private registry) and pull secret generation
- Automatic deployment of one or multiple Kubernetes manifests and/or Helm charts
- Automatic ingress configuration
Debug deployments using devspace analyze, devspace logs and devspace enter
Develop applications directly inside Kubernetes using devspace dev
Create private and isolated namespaces with a single command: devspace create space my-space

3. Customize your workflows and keep them consistent across your entire team

4. Build CI/CD pipelines faster with DevSpace CLI

How does DevSpace CLI acclerate and automate my workflow?

Containerize any project in minutes

Containerize your project

devspace containerize

DevSpace CLI detects your programming language and creates a Dockerfile for your project.

Initialize your project

devspace init

DevSpace CLI creates a configuration for deploying and developing with Kubernetes based on:

your Dockerfile(s)
your Helm chart(s)
your Kubernetes manifest(s)

Deploy containerized applications with ease

Deploy your application

devspace deploy

What does `devspace deploy` do?

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 Hosting to get a fully managed Kubernetes namespace.

Develop cloud-native software faster than ever

Develop in a production-like environment

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. It works in any container with and without volumes.

DevSpace CLI provides the following development features:

Debug deployments without hassle

Speed up finding and solving issues

devspace analyze

DevSpace CLI 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:

Getting started with DevSpace CLI

1. Install DevSpace CLI & Docker

via NPM

npm install -g devspace

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;

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

Install Docker (optional but recommended)

Install Docker

DevSpace CLI allows you to build images directly inside Kubernetes pods (using kaniko) but if you have Docker installed, DevSpace CLI can also build images locally using Docker. 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)

2. Initialize your application

Run this command in your project root directory to create a deployment and development configuration for Kubernetes:

devspace init

Don't have a project to test DevSpace with? Check out our example project.

git clone https://github.com/devspace-cloud/quickstart-nodejs

3. Create a space (optional)

If you are using the free managed clusters provided by DevSpace Cloud or you connected your own Kubernetes cluster to DevSpace Cloud, you can now create an isolated Kubernetes namespace using the following command:

devspace create space my-app

4. Deploy your application

Deploy your application to kubernetes:

devspace deploy

What's next?

Contributing

Help us make DevSpace CLI the best tool for developing, deploying and debugging Kubernetes apps.

Reporting Issues

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.

Feedback & Feature Requests

You are more than welcome to open issues in this project to:

Contributing Code

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.

FAQ

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 CLI with my existing Kubernetes clusters?

Yes. You have two options:

Connect your existing Kubernetes clusters to DevSpace Cloud as external clusters (available soon). DevSpace Cloud will then be able to automatically manage cluster users and permissions. This lets you created isolated namespaces (Spaces) within 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 CLI?

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 isolated 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
Dynamic resource auto-scaling within the configured limits

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.

Learn more about Helm charts

License

You can use the DevSpace CLI for any private or commercial projects because it is licensed under the Apache 2.0 open source license.

KaelBaldwin/devspace