Getting Started with Orka Small Teams

📘

Orka (Small Teams), at a Glance

If you haven't already, check out Orka, at a Glance for a quick breakdown of getting ready to use Orka for your first time. You can start at step 1.2 for Orka Small Teams.

Orka Small Teams is very similar to Orka, but has a few key differences. Namely, Orka Small Teams' defining differences are that the clusters are standardized and slimmed down to the bare resources that are needed.

• 1 x Master Node
• 2 x M2 Mini Worker Nodes
• 1 x ASA v5 Firewall
• 500GB of Network Storage (Hard Quota)
  • Shared between Images and Shared VM Storage
• Fixed & Predefined IP Scheme

Set up your desired method of interfacing with Orka

You can get started using Orka Small Teams using the following guides from our Orka Docs.

• The WebUI is a quick and easy way to get started using your Orka cluster using a graphical interface.
• The CLI is best for quick, one time commands, and is the quickest to get started with.
• The API is best for more advanced users or complex use cases, such as those who wish to develop a custom in-house solution using Orka

Getting Familiar with Orka

The following Orka documentation is releveant to Orka Small Teams and goes over some of the most applicable topics from our Orka Docs to get started with Orka.

Images & Image Management

• With Orka Small Teams, you are able to customize your image by adding any applications and implementing any configurations you want in a VM.
• MacStadium provides only base MacOS images, we do not include any additional developer tools or programs. You are free to add these to your images yourself.
• You can commit your changes to either the base image, or save the changes as a new image to preserve the existing image.
• You also have 500GB of storage that can be used to store a number of images (dependent on size of image).

VM Tools

• Our base image includes the latest version of our VM-Tools, which runs inside the VM. These tools are what allow Orka to interface with the VM properly.
• When your cluster is upgraded, you will need to update the VM-Tools in your images manually or pull the latest image with the latest VM-Tools baked in.

API Documentation

• Using the API you can accomplish any task in a programatic fashion

CLI Commands

• Using the CLI you can interface with the cluster in real time using quick commands and interactive prompts

Working with VMs

• This guide details VM Workflows and known limitations with VMs

Logging

• This page page will help you pull logs from Orka for the purposes of both monitoring and troubleshooting

Getting started with CI/CD on OST

Pick you your set oftools and plug-ins to integrate into Orka, and then you can follow the CI/CD Quick Start Guide to get started using your Orka Cluster for CI/CD. Keep in mind Orka Small Teams only runs on Orka 2.4.1 or later, which means your Orka Endpoint will be at .20

Orka Downloads

• Orka VM Tools
• Orka CLI

📘

Known limitations

At the moment, only MacOS Ventura is supported

Apple Silicon Support

• Orka Small Teams environments only consist of worker nodes running on Apple Silicon

Apple Silicon Limitations

• There are some limitations in Apple Silicon, which inherently will be present in Orka Small Teams environments due to the fact that they only consist of Apple Silicon worker nodes.