Skip to content

lithops_quick

Aletibazo edited this page Jun 11, 2024 · 1 revision

Quick Start

After downloading the appliance from Marketplace, follow this steps to have a basic Lithops instance with localhost compute and storage backends.

Steps to deploy a Lithops instance:

  1. Download the Lithops appliance from the OpenNebula Community Marketplace. This will download the VM template and the image for the OS.

    $ onemarketapp export 'Service Lithops' Lithops --datastore default
    
  2. Adjust the VM template as desired (i.e. CPU, MEMORY, number of disks). It should look similar to this:

     CONTEXT = [
         NETWORK = "YES",
         ONEAPP_LITHOPS_BACKEND = "$ONEAPP_LITHOPS_BACKEND",
         ONEAPP_LITHOPS_STORAGE = "$ONEAPP_LITHOPS_STORAGE",
         ONEAPP_MINIO_ACCESS_KEY_ID = "$ONEAPP_MINIO_ACCESS_KEY_ID",
         ONEAPP_MINIO_BUCKETT = "$ONEAPP_MINIO_BUCKETT",
         ONEAPP_MINIO_ENDPOINT = "$ONEAPP_MINIO_ENDPOINT",
         ONEAPP_MINIO_ENDPOINT_CERT = "$ONEAPP_MINIO_ENDPOINT_CERT",
         ONEAPP_MINIO_SECRET_ACCESS_KEY = "$ONEAPP_MINIO_SECRET_ACCESS_KEY",
         SSH_PUBLIC_KEY = "$USER[SSH_PUBLIC_KEY]" ]
     CPU = "1"
     DISK = [
         IMAGE = "service-Lithops" ]
     GRAPHICS = [
         LISTEN = "0.0.0.0",
         TYPE = "VNC" ]
     HYPERVISOR = "kvm"
     INPUTS_ORDER = "ONEAPP_LITHOPS_BACKEND,ONEAPP_LITHOPS_STORAGE,ONEAPP_MINIO_ENDPOINT,ONEAPP_MINIO_ACCESS_KEY_ID,ONEAPP_MINIO_SECRET_ACCESS_KEY,ONEAPP_MINIO_BUCKETT,ONEAPP_MINIO_ENDPOINT_CERT"
     LOGO = "images/logos/lithops.png"
     MEMORY = "768"
     MEMORY_UNIT_COST = "MB"
     USER_INPUTS = [
         ONEAPP_LITHOPS_BACKEND = "O|text|Compute backend| |localhost",
         ONEAPP_LITHOPS_STORAGE = "O|text|Storage backend| |localhost",
         ONEAPP_MINIO_ACCESS_KEY_ID = "O|text|MinIO account user access key| |",
         ONEAPP_MINIO_BUCKETT = "O|text|MinIO bucket name| |",
         ONEAPP_MINIO_ENDPOINT = "O|text|MinIO endpoint URL| |",
         ONEAPP_MINIO_ENDPOINT_CERT = "O|text64|CA certificate for MinIO connection| |",
         ONEAPP_MINIO_SECRET_ACCESS_KEY = "O|text|MinIO account user secret access key| |" ]
    
  3. Instantiate Lithops template:

    $ onetemplate instantiate Lithops
    

    This will prompt the user for the contextualization parameters, set the defaults for localhost compute and storage backends.

  4. Attach a new NIC to the VM:

    $ onevm nic-atttach VM_ID --network VNET_ID
    
  5. Access your new Lithops instance and check Lithops is working:

    $ onevm ssh VM_ID
    
    root@localhost:~# lithops hello
    

Next: Lithops Features and usage