Set up your local data service location#
The quickest way to get started with Ametnes Cloud is to set up your local workstation as an Ametnes Data Service Location.
In this article, you will learn how easy it is to deploy data services on your local workstation. We will create a JupyterHub service on your local workstation and connect to it locally.
Here is a summary of the steps you will need to follow. Firstly, install the prerequisite software if not present then we create a kubernetes cluster and set it up as an Ametnes Data Service location and then finally, we create a simple data application.
If you do not have an Ametnes Cloud account, sign up here to create one.
Setting up an Ametnes Data Services Location#
An Ametnes Data Service Location is basically a kubernetes cluster that is set up and connected to the Ametnes Cloud control plane. It will generally be a dedicated cluster but that is not mandatory.
Depending on your operating system, the prerequisites to get you started will differ.
Setup the chocolatey package manager. For this you need to start PowerShell with elevated permissions as an Administrator. Once this is done, run the following command.
Install docker desktop with
Install docker using Homebrew with
After the installation is done, launch docker and enter your password when prompted to give docker priviledge access.
sudo apt update sudo apt install apt-transport-https ca-certificates curl software-properties-common -y curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add - sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu focal stable" -y sudo apt install docker-ce -y sudo usermod -aG docker $USER sg docker -c "bash" sudo systemctl status docker
Install helm package manager
Enable kubernetes in Docker Desktop#
From the Docker Dashboard, select the Settings icon.
Select Kubernetes from the left sidebar menu.
Next to Enable Kubernetes, select the checkbox.
Select Apply & Restart to save the settings and then select Install to confirm.
- This instantiates images required to run the Kubernetes server as containers, and installs the /usr/local/bin/kubectl
Install the Ametnes Cloud Agent#
Add the helm repository.
Generate a UUID on your command line. This is how your local computer will be identified at the Ametnes Cloud control plane.
If you are on Windows, the command may not work. You can alternatively generate the uuid online from here
Install the Ametnes Cloud Agent and set the
agent.config.locationto the UUID generated above.
In your Ametnes Cloud console account, create a Data Service Location with
- Login into your Ametnes Cloud account here.
- Nagivate to the Service Locations menu on the left
- Click New Location
- Enter the following
- User Supplied Id:
- User Supplied Id:
After a short while, the data service location should come
Create the service#
- Using the Services left menu, navigate to the service management dashboard.
- Click New Service.
- Enter the Jupyter to filter from the list and select Create
- In the displayed form, enter the following info.
- Enter the Name:
- Select a Version from the list.
- Select the Location:
- Enter the Name:
Using the Services left menu, navigate to the service management dashboard. Your service should be listed.
Service not showing
If your service list is empty, use the filter at the top right corner, to filter for ALL services.
After a while, your data service status will change to
- To the right of your service, click the
Adminbutton and you will navigate to your service's details page.
- At the bottom of the page, copy the endpoint of your service as well as your username/key and password.
- In your browser, paste the URL
- You should get a prompt to login.
Delete all services#
- In your Ametnes Cloud console, navigate to the Admin section of each service
- Delete the service.
Uninstall the cloud agent#
In your terminal, enter
In this post, we explored how to set up your local workstation as an Ametnes Data Service location. This then allowed us to deploy a JupyterHub service that we were able to connect to.