Content Comparison

...

aws ec2 create-key-pair --key-name 'my-dev-key' --query 'KeyMaterial' --output text --region us-east-2 > my-dev-key.pem

chmod 400 my-dev-key.pem

• x-install tool: Version 1.0.0.13+

Installation Steps

Creating a Sandbox EKS Cluster and Deploying the Management Server

1. Create a Standalone Stack

Go Navigate to the directory where x-install is downloaded and use the following command to create a standalone stack:(Please modify the stack , customizing the cluster name, VPC CIDR, SSH key pair, and region to suit your environment.):

x-install create-standalone \
  --cluster=xio-standalone \
  --vpc-cidr=10.0.0.0/16 \
  --ssh-key-pair-name=my-dev-key \
  --region=us-east-2

• The new VPC and EKS cluster will inherit the stack name.

• The VPC will be assigned the CIDR block 10.0.0.0/16.

• The EC2 SSH key pair, my-dev-key, will be used to access the Exostellar Management Server.

2. Verify Post-Installation Readiness

After the standalone stack is successfully created, use the following command to check if the stack is ready:

...

3. Add an X-Compute Node to the Standalone EKS Cluster

To add an X-Compute node to the newly created standalone EKS cluster, first SSH into the Exostellar Management Server:

ssh -i "my-dev-key.pem" rocky@<management-server-public-ip>

...

Deploying the Management Server into an Existing EKS Cluster

1. Add Necessary IAM Permissions

Ensure all required IAM resources are present by running:

x-install apply-iam --cluster xio-standalone --region us-east-2

2. Check the Target Environment

Verify the existing EKS cluster meets installation prerequisites:

eksx-node-cliinstall addprecheck -n node-00 -c 1 -m 4096 -p pool-a -r az1 -k xio-standalone

kubectl get node -l eks.amazonaws.com/nodegroup=x-compute

The output should display the new nodes as ready:

NAME--cluster=xio-standalone --ssh-key-pair-name=my-dev-key.pem

3. Install the Management Server

Deploy the Management Server into the existing EKS Cluster:

x-install apply --cluster xio-standalone

4. Integrate the Management Server with the Existing EKS Cluster

Run the following command to complete the integration:

x-install eksconfig --cluster xio-standalone

Adding X-Compute Nodes to the EKS Cluster via eks-node-cli

1. Access the Management Server

SSH into the Exostellar Management Server using:

ssh -i "my-dev-key.pem" rocky@<management-server-public-ip>

2. Add a New Node

Run this command on the server to add a new node to the EKS cluster:

eks-node-cli add -n node-00 -c 1 -m 4096 -p pool-a -r az1 -k xio-standalone

kubectl get node -l eks.amazonaws.com/nodegroup=x-compute

NAME                                          STATUS   ROLES    AGE     VERSION
ip-10-0-39-220.us-west-1.x-compute.internal   Ready    <none>   4m17s   v1.29.3-eks-ae9a62a

x-install update-kubeconfig --cluster=xio-standalone

Adding X-Compute Nodes to the EKS Cluster via Exostellar Karpenter

Reference deployment example:

cat <<EOF | kubectl apply -f -
apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx
spec:
  selector:
    matchLabels:
      app: nginx
  replicas: 2
  template:
    metadata:
      labels:
        app: nginx
    spec:
      tolerations:
      - key: "exokarpenter.sh/x-compute"
        operator: "Exists"
        effect: "NoSchedule"
      affinity:
        nodeAffinity:
          requiredDuringSchedulingIgnoredDuringExecution:
            nodeSelectorTerms:
            - matchExpressions:
              - key: exokarpenter.sh/nodepool
                operator: In
                values:
                - pool-a
      containers:
      - name: nginx
        STATUSimage: nginx:1.14.2
       ROLES ports:
  AGE     VERSION ip-10-0-39-220.us-west-1.x-compute.internal   Ready- containerPort: 80
        resources:
          <none>  requests:
4m17s   v1.29.3-eks-ae9a62a

x-install update-kubeconfig --stack-name=xio-standalone

4. Clean Up

...

              cpu: 1
EOF

Cleaning Up

The entire standalone stack can be deleted with the destroy command:

...

To explore other subcommands, use the following command for a list of available options:

x-install --help