Lambda-cloud-manager is a lightweight command line tool and Python SDK that helps manage Lambda Cloud Instances via the Cloud API.

Currently, poetry is the easiest way to install the package. Just run:

poetry add git+https://github.com/joehoover/lambda-cloud-manager.git

1. Store your Lambda Cloud API Key as an environmental variable:

   export LAMBDA_API_KEY="<your-key-here>"

2. Interact with the Lambda Cloud API via your CLI using the lcm tool. The following commands are supported:

   • get-instance-types
   • get-instances
   • ssh-keys
   • write-config
   • launch
   • terminate

First, let's see what instances are available.

lcm get-instance-types

This logs Lambda Cloud instance types to the console. And, when we find the gpu_1x_a10 instance, we see:

{
   "gpu_1x_a10": {
      "instance_type": {
         "name": "gpu_1x_a10",
         "price_cents_per_hour": 60,
         "description": "1x A10 (24 GB PCIe)",
         "specs": {
            "vcpus": 30,
            "memory_gib": 200,
            "storage_gib": 1400
         }
      },
      "regions_with_capacity_available": [
         {
            "name": "us-west-1",
            "description": "California, USA"
         }
      ]
   }
}

Let's go ahead and generate a config for this instance. We just need to specify the path for our config:

lcm generate-config ./configs/a10.json

This will log the following to your console:

INFO:root:Wrote the following config to `configs/test.json`...
INFO:root:{
    "region_name": "us-west-1",
    "instance_type_name": "gpu_1x_a10",
    "ssh_key_names": [
        ""
    ],
    "file_system_names": [],
    "quantity": 1
}

Now, you need to add your Lambda Cloud ssh key name to the config. If you haven't created one, do that now. Or if you do have one, but you can't remember the name, you can just run:

lcm ssh-keys

which will return information about your configured SSH keys.

To launch your instance, you can just run:

lcm launch ./configs/a10.json --name test-instance

This will log a response like:

{
    "instance_ids": [
        "bd7cb0ccfb574f6c876f6c9b1ba5ad38"
    ]
}

Let's see if it's running:

lcm get-instances

You can terminate instances by name:

lcm terminate --name test-instance

or in bulk:

lcm terminate --all