Comment on page
Use our free Cloud sandbox, or install the Open Source Docker Image
To get up and running on your unSkript journey quickly, we've created two options:
- 1.A local install using the the open source Docker image.
- 2.A free sandboxed version of our Cloud product.
The fastest way to get the open source version of unSkript running is via our Docker container.
With Docker, you can get up and running in two steps (and just one if you already have Docker up and running!)
- 1.Clone out GitHub Repository (In this case we are installing in $HOME.)cd $HOMEgit clone https://github.com/unskript/Awesome-CloudOps-Automationcd Awesome-CloudOps-Automation
- 2.In the terminal, run the following command (if you installed the GitHub in a different location - change line 2 appropriately):docker run -it -p 8888:8888 \-v $HOME/Awesome-CloudOps-Automation/custom:/data \-v $HOME/.unskript:/unskript \-e ACA_AWESOME_MODE=1 \--user root \docker.io/unskript/awesome-runbooks:latest
Your installation will be available to use at:
Note: the -
e ACA_AWESOME_MODE=1allows for syncing data between docker and your local machine, and the two -v commands indicate where the data (RunBooks and Actions) and unskript (credentials) will be stored.
Omitting these three lines will result in a "read-only" version of unSkript.
Here are the steps to launch the unSkript Docker image in k8s:
- Deploy using the following command (the Yaml file is in our GitHub repository)
kubectl apply -f unskript-oss-k8s-deployment.yaml
- To access the jupyter server, you will have to enable port-forwarding using
kubectl port-forward <pod corresponding to this deployment> -n <k8s namespace> 8888:8888&
unSkript offers a free cloud sandbox that can be easily accessed in your browser.
- 2.On the sign up screen, you may either use Google to sign in, or you can use your email address to create an account (this will require email verification).
Once you have verified your account, you'll be walked through a overview of the platform where you will create a xRunBook in three steps:
- 3.Create a xRunBook This step will walk you through the creation of a xRunBook
- 1.First you'll create a xRunBook with a name, optional description and the Proxy you created in the first step.
- 2.Next we'll open the editor to begin creating the xRunBook.
- 3.xRunBooks are built by combining Actions. In the walkthrough we'll add the
MongoDB Find DocumentAction from the installed Actions, by searching for the term, and then dragging the Action into our xRunbook.
- 5.Now you are ready to run your first xRunBook. Click
Run Actionto just run the Action, or you can click the
Run XRunBookto run the entire RunBook. A list of movies will be the output.
- 6.Now you are ready to create your own xRunBooks!