Released as a technology preview during the latest DockerCon (June 2015), VMware AppCatalyst is an API and Command Line Interface (CLI)-driven Mac hypervisor that is purpose-built for developers. Once installed, VMware AppCatalyst allows to quickly and easily deploy Linux container hosts based on VMware Project Photon.
[…] VMware AppCatalyst offers developers a fast and easy way to replicate a private cloud locally on their desktop for building and testing containerized and microservices-based applications. The tool features Project Photon, an open source minimal Linux container host, Docker Machine and integration with Vagrant.
AppCatalyst leverages the same hypervisor that ships in Fusion. However, don’t try to find a GUI as only the CLI and the API are exposed to rapidly deploy and operates instances. 🙂
From the AppCatalyst community, we learn that:
AppCatalyst is offered as a free download, and is optimized for developer workloads. To do so, AppCatalyst focuses on API- and command-line interface access, ships with a container runtime, and is designed to provide an environment consistent with that in the production stack. In short, AppCatalyst makes it easy for developers to write, test, and ship code.
By using AppCatalyst’s CLI (or API), you can create/clone Photon instances from the template provided, generate a list of all named VMs available to the logged in user, start those Photon instances, get their IP, ssh to the instances and launch containers. With this model, AppCatalyst handles the VM creation, power-on, etc so the developer can focus on building, running, and testing their app.
The installation procedure is very straightforward: download the AppCatalyst .dmg file, launch the installer, and follow the usual steps (accept EULA, choose destination folder, and so on).
To start doing some awesomeness, navigate to
/opt/vmware/appcatalyst/bin (you can add this directory to the path for easier future interaction) and execute
appcatalyst to get a list of available commands. As you can see in the screenshot below, the CLI is quite basic but adequate! 🙂
VM listing (I had already a VM named
rdecker@rdecker-mbpr ~/Documents/AppCatalyst$ appcatalyst vm list Info: VMs found in '/Users/rdecker/Documents/AppCatalyst' deathstar
rdecker@rdecker-mbpr ~/Documents/AppCatalyst$ appcatalyst vm create milleniumfalcon Info: Cloned VM from '/opt/vmware/appcatalyst/photonvm/photon.vmx' to '/Users/rdecker/Documents/AppCatalyst/milleniumfalcon/milleniumfalcon.vmx'
List all powered-on VM:
rdecker@rdecker-mbpr ~/Documents/AppCatalyst$ appcatalyst vmpower list Info: No powered-on VMs found in '/Users/rdecker/Documents/AppCatalyst'
Start a VM:
rdecker@rdecker-mbpr ~/Documents/AppCatalyst$ appcatalyst vmpower on deathstar 2015-08-04T11:20:47.696| ServiceImpl_Opener: PID 35717 Info: Completed power op 'on' for VM at '/Users/rdecker/Documents/AppCatalyst/deathstar/deathstar.vmx' rdecker@rdecker-mbpr ~/Documents/AppCatalyst$ appcatalyst vmpower on milleniumfalcon 2015-08-04T11:21:00.293| ServiceImpl_Opener: PID 35775 Info: Completed power op 'on' for VM at '/Users/rdecker/Documents/AppCatalyst/milleniumfalcon/milleniumfalcon.vmx'
When a Photon container host is created and started, you only have to connect to the VM via SSH and launch containers: Docker is already installed, configured and started. To connect via SSH, you need first to get the IP address of the VM with
appcatalyst guest getip .
rdecker@rdecker-mbpr ~/Documents/AppCatalyst$ appcatalyst guest getip deathstar 192.168.85.129
SSH to the VM using the private key stored in AppCatalyst installation folder:
rdecker@rdecker-mbpr ~/Documents/AppCatalyst$ ssh -i /opt/vmware/appcatalyst/etc/appcatalyst_insecure_ssh_key email@example.com The authenticity of host '192.168.85.129 (192.168.85.129)' can't be established. RSA key fingerprint is 77:e8:6e:02:72:a2:13:98:f3:36:00:ba:c1:06:ae:22. Are you sure you want to continue connecting (yes/no)? yes Warning: Permanently added '192.168.85.129' (RSA) to the list of known hosts. Last login: Fri Jun 19 20:51:42 2015 from 192.168.217.1 photon [ ~ ]$ sudo docker info Containers: 0 Images: 0 Storage Driver: overlay Backing Filesystem: extfs Execution Driver: native-0.2 Logging Driver: json-file Kernel Version: 3.19.2 Operating System: VMware Photon/Linux CPUs: 1 Total Memory: 489.8 MiB Name: photon ID: 3BAY:KC43:24HE:7KSG:JEVM:2FY7:RVX7:TZPQ:XGR3:VSGH:NX72:IY7J photon [ ~ ]$ sudo docker version Client version: 1.7.0 Client API version: 1.19 Go version (client): go1.4.2 Git commit (client): 0baf609 OS/Arch (client): linux/amd64 Server version: 1.7.0 Server API version: 1.19 Go version (server): go1.4.2 Git commit (server): 0baf609 OS/Arch (server): linux/amd64 photon [ ~ ]$
Finally, you can launch the container of your choice to validate the installation, such as the usual Nginx image available in the vmwarecna repository.
photon [ ~ ]$ sudo docker run -d -it -p 80:80 vmwarecna/nginx
Start a browser and enter the IP address of your Photon VM to see the Nginx container running…or do something more fancy! 🙂
photon [ ~ ]$ sudo docker run -it ubuntu sh -ic "apt-get update -q && apt-get install cmatrix && cmatrix"
- Ensure that VMware Fusion is not running before installing AppCatalyst.
- By default, all VMs will be cloned from the Photon template (
/opt/vmware/appcatalyst/photonvm) and placed into the default directory (
- Retrieving the guest IP address can take a few seconds, patience you must have my reader.
- Remove the concerned folder to remove a VM. There is currently no command implemented for this action.
- If the Power ON operation is impossible for an instance, verify first that VMware Fusion is not running. In last resort, you can try a reboot. I had a dependency mismatch that resolved itself with a reboot.
To download the latest build, seek assistance, and provide feedback, please visit the AppCatalyst community site: http://www.vmware.com/go/communities-appcatalyst.