ZVM Cloud Shell

An awesome docker based PowerShell platform with Zerto PowerShell module and VMware PowerCLI preinstalled!
Explore the docs »

Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
4. Contributing
5. Contact
6. Acknowledgments

About The Project

Have you ever wanted to run a quick one-liner command, or do some automation against the Zerto PowerShell interface, only to realize you have an outdated version of PowerShell, or you don't have the Zerto PS Module installed on your machine? Wouldn't it be easier to have all the scripting tools installed on a dedicated platform where they don't interfere with your desktop? Wouldnt it be great to access it all without installing any software?

Of course it would! This cloud shell style docker container does just that. It starts life as the standard Microsoft Powershell container based on Ubuntu, then I add GoTTY as well as the Zerto PowerShell Module. From there all you need to do is run the docker-compose and access the web terminal.

(back to top)

Built With

This section should list any major frameworks/libraries used to bootstrap your project. Leave any add-ons/plugins for the acknowledgements section. Here are a few examples.

• Docker
• PowerShell
• GoTTY

(back to top)

Getting Started

This cloud shell project is meant to provide an easy to use envionment to run scripts and commands that leverage the Zerto PowerShell module.

Prerequisites

To run this container you need a Linux machine with Docker and docker-compose installed.

Installation

Below is an example of how you can instruct your audience on installing and setting up your app. This template doesn't rely on any external dependencies or services.

1. Clone the repo

   git clone https://github.com/recklessop/zvm-cloud-shell.git

2. Edit Docker-Compose YAML file and configure your ZVM password if you wish. You can also change the port where the web terminal will run. By default it is 5678

3. start the container using docker-compose

   docker-compose build

4. start the container using docker-compose

   docker-compose up -d 

(back to top)

Usage

Once you have started the container, you can access the web terminal and run PowerShell cmdlets from the Zerto PowerShell Module.

For more examples, please refer to the Documentation

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

Contact

Justin Paul - @recklessop - [email protected]

Project Link: https://github.com/recklessop/zvm-cloud-shell

(back to top)

Acknowledgments

Use this space to list resources you find helpful and would like to give credit to. I've included a few of my favorites to kick things off!

• coming soon

(back to top)