LLMstudio is available as a container service on AWS Marketplace. This tutorial shows to deploy the containerized application on EKS.

​
Prerequisites

In order to follow this tutorial you need to:
  • Have AWSMarketplaceFullAccess policy permission in your AWS account
  • Have a valid subscription to LLMstudio on AWS marketplace

​
Setup Prerequisite command-line tools

  1. Open AWS CloudShell
  2. Run the following commands to install the prerequisite command-line tools:
mkdir software \
&& cd software \
&& ARCH=amd64 PLATFORM=$(uname -s)_$ARCH && \
curl -sLO "https://github.com/eksctl-io/eksctl/releases/latest/download/eksctl_$PLATFORM.tar.gz" && \
tar -xzf eksctl_$PLATFORM.tar.gz -C /tmp && \
sudo mv /tmp/eksctl /usr/local/bin && \
rm eksctl_$PLATFORM.tar.gz && \
curl -o kubectl https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.4/2023-08-16/bin/linux/amd64/kubectl && \
chmod +x kubectl && \
sudo mv kubectl /usr/local/bin && \
wget -q https://get.helm.sh/helm-v3.12.3-linux-amd64.tar.gz && \
tar -zxvf helm-v3.12.3-linux-amd64.tar.gz && \
sudo mv linux-amd64/helm /usr/local/bin/helm && \
rm -rf helm-v3.12.3-linux-amd64.tar.gz linux-amd64 && \
curl -L https://github.com/a8m/envsubst/releases/download/v1.2.0/envsubst-$(uname -s)-$(uname -m) -o envsubst && \
chmod +x envsubst && \
sudo mv envsubst /usr/local/bin && \
sudo yum install -y yum-utils && \
sudo yum-config-manager --add-repo https://rpm.releases.hashicorp.com/AmazonLinux/hashicorp.repo && \
sudo yum -y install terraform && \
sudo yum update -y && \
sudo amazon-linux-extras install -y docker \
&& echo $(nohup sudo dockerd > /tmp/dockerd.log 2>&1 &);

​
Pull Images from ECR

When you subscribe to the product on AWS Marketplace, you’ll be given a command to pull the images from ECR. After running the given commanf you’ll get the ECR Repository URL and the image version, which you need to set as environment variables. 
export ECR_REPOSITORY=<ecrrepourl>
export PRODUCT_VERSION=<version>

​
Create cluster

  1. Create a file called cluster.yaml with the following format:
  1. Run the following command to create an EKS cluster.
export AWS_REGION=<REGION>
export PRODUCT_NAME=<PRODUCT_NAME>
envsubst < cluster.yaml > $PRODUCT_NAME-cluster.yaml
eksctl create cluster -f $PRODUCT_NAME-cluster.yaml

​
Wait for EKS Cluster

  • It takes 10-20 minutes for the EKS cluster to be created.
  • You will see a prompt in the CLI when the cluster is ready.

​
Create Deployment File

  1. Create a file called deployment.yaml with the following format:
  1. Add environment variables needed, e.g the API Keys for the models you need:

export OPENAI_API_KEY="...."
  1. Run the following command to create a deployment file for your container image with the environment variables set:
envsubst < deployment.yaml > $PRODUCT_NAME-deployment.yaml

​
Deploy Container Image

Run the following command to deploy the container image into the EKS cluster: 
kubectl apply -f $PRODUCT_NAME-deployment.yaml

​
Check Pod Status

Once the container starts, check the pod status with the following command: 
kubectl get pods -n mcp
  • Wait and re-run the previous command until the STATUS shows Running.
  • The output should look similar to this:
NAME                  READY   STATUS    RESTARTS   AGE
llmstudio-proxy       1/1     Running   0          79s

​
View Logs

Run the following command to get the log output of the pod: 
kubectl logs "$(kubectl get pods -n mcp --output name)" -c contract-app -n mcp
You’ll see the application server startup: 
Running LLMstudio Proxy on http://0.0.0.0:50001
And that’s it! You’ve deployed LLMstudio 🎉