Skip to content

A toolkit container for automating Nutanix and Kubernetes

License

Notifications You must be signed in to change notification settings

nutanixdev/nutanix-devstation

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

44 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Nutanix Dev Station

A toolkit container for automating Nutanix and its applications, deploying Kubernetes, and operating the platform at scale.

Features

  • Cross-platform: Windows and Mac (Intel or Apple silicon) are validated.
  • Works with Docker Desktop and Rancher Desktop (dockerd - moby).

NOTE

Windows users must clone the repo using the following command to avoid issues with CRLF.

git clone https://github.com/nutanixdev/nutanix-devstation.git --config core.autocrlf=false

Tools included

CLIs

  • Python v3.12.x (Debian 12 bookworm)
  • Calm DSL latest (last validated: 3.7.2.1)
  • PowerShell latest (last validated: 7.4.2)
  • Ansible v2.16.6 (pip v9.5.1)
  • Terraform v1.5.5 (latest releases under MPL)
  • Packer v1.9.2 (latest releases under MPL)
  • Kubectl latest (last validated: 1.30.0)
  • Helm latest (last validated: 3.14.4)
  • minikube latest (last validated: 1.33.0)
  • Kubectl-karbon latest (last validated: 0.11.5)
  • OpenShift CLI (oc) stable-4.15 (last validated: 4.15.9)
  • OpenShift Install stable-4.15 (last validated: 4.15.9)
  • Clusterctl v1.7.1
  • k9s v0.32.4
  • Cookiecutter v2.5.0
  • GitHub CLI latest (last validated: 2.48.0)
  • Nutanix CLI (nCLI)
  • Acropolis CLI (aCLI)

VS Code Extensions

  • Docker
  • HashiCorp Terraform
  • JSON Path Status Bar
  • Kubernetes
  • REST Client
  • YAML

Requirements

How it works

The Nutanix Dev Station doesn't ship a container image, instead it builds a local image in your computer based on the settings in the devcontainer.json file included in the .devcontainer directory. It uses the Microsoft Visual Studio Code Dev Containers extension, and we just provide a standard configuration file with several tools enabled. You can customize it adding, updating, or removing tools.

When opening a project in VS Code that includes the .devcontainer directory, the Dev Container extension prompts the option for building the container. Then the project folder is mounted inside the container. The content of the project folder is always available regardless of opening it locally or in the container.

Additionally, two container volumes are used for persisting Calm DSL cache and bash history after rebuilding the container when making changes to devcontainer.json.

How to use

Quick Install

  1. Clone, or download and extract the repository.

  2. Open the folder in VS Code and when prompted, click Reopen in Container.

  3. Enjoy the Nutanix Dev Station!

Re-use Dev Containers in another project

You only need the .devcontainer directory in the project root folder:

  1. Clone, or download and extract the repository.

  2. Copy or move the .devcontainer directory to your project.

Advanced Settings

To enable/disable or configure different tool versions, edit the devcontainer.json file in the .devcontainer directory.

How to contribute

We gladly welcome contributions from the community. From updating the documentation to adding more functions for Dev Station, all ideas are welcome. Thank you in advance for all of your issues, pull requests, and comments!

Terms of use

https://www.nutanix.com/legal/terms-of-use

CHANGELOG

Version 0.5.0

  • OS updated to Debian 12 bookworm

Version 0.4.0

  • Python updated to version 3.12

Version 0.3.0

  • Support for persistent user profile (.calm and .nutanixdev volumes are migrated to a new one)
  • Tool versions have been updated.
  • Fix zsh history.
  • Include detailed changelog file.
  • Update and include new Nutanix SDKs for Nutanix Disaster Recovery, Microseg and Networking.
  • Normalization (LF and CRLF)

Version 0.2.0

This version is EA and has been tested with different OSes and container engines.

Version 0.1.x

0.1.x versions were the initial version of the Nutanix Dev Station and used internally for demos.