10. Managing Stateful Applications¶
Kubernetes is a framework for managing complex applications in a containerized environment. It provides various facilities for managing container placement, resource allocation, service discovery, load balancing, scaling, etc. Kubernetes does not, however, have a notion of what an application actually is, nor is there a Kubernetes resource called ‘application’.
On a Kubernetes cluster, the pod is the basic operational unit. Containers are grouped into pods and deployed as individual units, or they are deployed under the control of various resource controllers such as ReplicaSet, StatefulSet, Deployment, etc. How to define a set of related Kubernetes resources as a single unit is left for users to decide. Fortunately, a number of solutions that address this problem have evolved in recent times:
Helm Release |
Helm is a tool that streamlines the installation and management of Kubernetes applications. A Helm chart is a collection of specifications describing a related set of Kubernetes resources. A Helm release is a specific instance of a Helm chart which has been deployed to a Kubernetes cluster. |
Custom Operator |
Custom Operators are specialized controllers that automate complex tasks beyond the scope of what Kubernetes itself provides. They provide a way to extend the cluster’s behavior without making modifications to Kubernetes itself. Many ISVs have developed Operators that deploy their software on Kubernetes. |
Topics covered in this chapter:
|
Create an application |
|
Register a stateful application |
|
Unregister a stateful application |
|
Delete an application |
|
List applications |
|
Display detailed information about an app |
|
Display the status of the objects associated with an app |
|
Attach an external storage repo to an app |
|
Detaches a previously attached repo from an app |
|
Configures a snapshot schedule for an app |
|
Configures a backup schedule for an app |
|
Start an application instance |
|
Stop an application instance |
|
Restart an application instance |
|
Revert an app to the point-in-time of specified snapshot or backup |
|
Configure application parameters |
|
Upgrade an application |
|
Configure various attributes/schedules of an app |
|
Share an app with one or more tenant users |
|
Stop sharing an app with one or more tenant users |
|
List application shares |
|
Reassign ownership of an app |
10.1. Application life cycle management¶
The lack of a proper Application construct in Kubernetes poses a problem when it comes to managing the life cycle of a complex application made up of various Kubernetes resources. For example, how would one snapshot or clone an entire Helm release that spans PersistVolumeClaims, Secrets, ConfigMaps, SatefulSet, Pods, Services etc? Or how about snapshotting a web tier, app tier and database tier each deployed separately using three different kubectl manifest files?
10.2. Robin Applications¶
Robin provides a framework for managing stateful applications deployed on a Kubernetes cluster. All resources that together deliver a service to the end user are collected together into a single unit, which Robin calls an Application. Robin maintains metadata on each of the application’s associated resources in its configuration database. This allows Robin to perform life cycle management operations, such as snapshot, backup, restore, etc., that encompass all of an application’s data and metadata (state of each Kubernetes resource). Three types of applications can be managed by Robin:
10.2.1. ROBIN¶
Robin Platform provides the ability to deploy applications to a Kubernetes cluster using custom Application Bundles containing all specifications and resources necessary for application deployment. When Robin Platform deploys the application, it takes responsibility for creating all relevant Kubernetes resources, such as StatefulSets, PersistentVolumeClaims, etc. Robin Applications are automatically handled by the Robin Platform framework.
10.2.2. Helm¶
Helm provides the ability to deploy applications to a Kubernetes cluster using Helm charts containing all specifications and resources necessary for application deployment. When Helm deploys an application, it takes responsibility for creating all relevant Kubernetes resources. Helm Applications are not automatically known to Robin Platform. But they can be registered with the Robin Platform cluster. In order for this to work, all storage for the application must be from the Robin Platform. The application also needs to be registered with Robin Platform.
10.2.3. FlexApp¶
Robin Platform also provides a very flexible mechanism for
registering any set of Kubernetes resources as a Robin Application.
The FlexApp construct uses label selector rules to group the
resources together. For example, --select app=apache --select
app=mysql would select Pods and PVCs for a web and database tier
together into a single FlexApp object. The command to create/register
a FlexApp, is detailed in the sections below.
10.3. Robin Application Bundles¶
Robin Platform offers a new type of application deployment framework called “Application Bundles”, which is ideally suited for complex workloads such as Cloudera, Oracle RAC, Splunk, SAP HANA, etc. An Application Bundle contains all resources necessary to deploy an application to a Kubernetes cluster, such as:
The list of services offered by the application. For example, services offered by MongoDB include ConfigServer, QueryRouter, Shards, ReplicaSets.
Which image to pull for each service. Note that images can be vendor published images, or they can be custom images hosted on a local registry.
Optionally, application specific placement constraints can also be specified. For example, anti/affinity policies for services.
All application configuration information is contained in a YAML file, called the ‘manifest’ file. The manifest file, icon file, and any application-specific life cycle hook scripts are packaged into a single tar file and uploaded to the Robin Platform as an Application Bundle.
Robin Platform’s Application Bundles enable an App Store-like experience for deploying any Application, with a special focus on the needs of complex distributed data-heavy Big Data, NoSQL and Databases. Once a bundle has been uploaded, a user can use it when deploying an application with a single click from the UI, a single command from the CLI, or a single REST call programmatically.
The highly flexible and customizable Robin Application Bundle framework offers application developers freedom from the underlying infrastructure. You define the application once and deploy it anywhere, on-prem or public clouds like AWS, Azure and Google Cloud.
Robin Platform comes pre-packaged with ready-to-use Application Bundles for several applications including:
Big Data: HortonWorks, Cloudera, Spark, ElasticSearch, ELK, Splunk
NoSQL: MongoDB, Cassandra, CouchDB
Databases: Oracle, Oracle RAC, SAP HANA, Microsoft SQL Server, IBM DB2, Postgres, MySQL, MariaDB
AI / machine learning: TensorFlow, Caffe, Theano, R, Jupyter
Users can onboard any application or database that runs on Linux very quickly. Refer to the Robin Application Bundle Guide for instructions.
10.3.1. Upload a Robin Application Bundle¶
Add a bundle to the Robin cluster with the following command:
# robin bundle add <bundle_name> <bundle_version> <bundle_file_pathname>
An example of its usage is shown below:
# robin bundle add mysql docker-8.0 docker-mysql-8.0-416_master.tar.gz
File upload: 100% -- (79763/79763)
Job: 118 Name: BundleAdd State: VALIDATED Error: 0
Job: 118 Name: BundleAdd State: COMPLETED Error: 0
Note
For more details on the above command refer to the documentation provided here.
10.3.2. Listing Application Bundles¶
List all the bundles currently present on the Robin cluster with the following command:
# robin bundle list
An example of its usage is shown below:
# robin bundle list
Bundle Id | Type | Owner/Tenant | Name | Version | Zone Id | Content Id | Description | Group Id | #Templates | #Apps
----------+-------+----------------------+----------+------------+------------+----------------------------------+-------------+----------+------------+-------
1 | ROBIN | admin1/t1 | mysql2 | docker-8.0 | 1580884960 | f428eeefd6d08ddb7ea91f38e4755771 | - | 4 | 0 | 0
2 | ROBIN | robin/Administrators | postgres | docker-9.5 | 1580884960 | 91120e615901bab8947b9d8380b186a1 | - | 2 | 1 | 1
3 | HELM | admin1/t1 | mysql | helm-1.6.2 | 1580884960 | 00f4243a24cc74624d7272a6217d425f | - | 3 | 0 | 0
Note
For more details on the above command refer to the documentation provided here.
10.3.3. Create an Application from a Robin Application Bundle¶
Create a Robin bundle based application with the following command:
# robin app create from-bundle <app_name> <bundle_id> <path_to_template> --rpool <rpool_name>
An example of its usage is shown below:
# robin app create from-bundle pgsql 2 postgres_template.json --rpool default --wait
Job: 115 Name: ApplicationCreate State: VALIDATED Error: 0
Job: 115 Name: ApplicationCreate State: WAITING Error: 0
Job: 115 Name: ApplicationCreate State: COMPLETED Error: 0
Note
For more details on the above command refer to the documentation provided here.
10.3.4. Advanced placement policies for Robin Application Bundles¶
One advantage of using Robin Application Bundles is that the Robin Platform, as the orchestrator, can enforce multiple placement policies. This is not a feature available in native Kubernetes deployers, such as Helm. This gives users additional control over the placement of pods, affinity rules, etc. for their deployment. Also, these placement policies can be applied independently on each service or role within the application. This fine-grained control helps optimize application performance, cluster utilization, and allows the user to easily customize their deployment based on their cluster configuration.
The placement policies that Robin Platform offers are:
Round-robin placement of pods within different nodes, racks, and datacenters. This rule makes sure that every deployed pod is placed on an a different instance within the specified infrastructure component, depending on available resources. This will spread the compute aspect of an application as much as possible.
Prevent placing more than one pod on the same node, rack, or datacenter. This rule makes sure that every deployed pod is strictly placed on an a different instance within the specified infrastructure. If that is not possible, the application creation will fail. This ensures that the compute aspect of the application is not piled up on one infrastructure piece alone.
Enforce Storage and Compute for all pods to be on same node, rack, or datacenter. This rule makes sure that every deployed pod has storage and compute affinity. As a consequence, each container and its associated volume(s) will be associated with the same infrastructure piece. Performance will obviously benefit.
Restrict the placement of pods to nodes tagged with specific tags ([key:value, …]). This rule makes sure that every deployed pod is placed only on hosts tagged with the specified key-value pairs (either via Kubernetes or Robin Platform). This allows a user to control exactly where a set of pods are spawned and thus optimize cluster utilization.
Do not place pods for service <A> on a node, rack, or datacenter which is also running service <B>. This rule makes sure that every pod deployed for a particular role will never be hosted by an infrastructure piece that is hosting any pods from a different, specified service. For example, the compute aspect of two different roles of an application could always be placed on separate pieces of infrastructure.
Always place pods for service <A> on a node, rack, or datacenter which is also running service <B>. This rule makes sure that every pod deployed for a particular role will always be hosted by an infrastructure piece that is hosting any pods from a different, specified service. For example, the compute aspect of two different roles of an application could always be co-located.
10.4. Helm Releases¶
A Helm chart is a collection of specifications describing a related set of Kubernetes resources. A Helm release is a specific instance of a Helm chart deployed to a Kubernetes cluster. Robin Platform supports the registration of a Helm release as a HELM Application, which allows the application to be managed using Robin Platform’s life cycle management facilities. In order for this to work, all storage for the application must be from the Robin Platform. The application also needs to be deployed to the user’s assigned Kubernetes namespace.
Moreover Robin allows for the auto-registration of Helm releases
when the config attribute k8s_auto_registration is set to true.
This results in any newly created instances of Helm charts being
exposed to the lifecycle management features Robin provides without
any user intervention. However there are certain caveats to utilizing this feature:
In order for an application to be auto registered there has to exist an underlying file collection with free space as a generic bundle for the release will be created and added.
Releases were created previously in namespaces that have since been imported into Robin will not be picked up immediately. As a result there will be an initial delay before the application is made visible to Robin users. Of course, one is always able to manually register the pre-existing application to hasten this process.
10.4.1. Register a Helm Release (Helm 2)¶
Note
Support for Helm 2 and Tiller is deprecated and will be removed in the next release.
Following is a step-by-step walkthrough, showing how to configure the Helm environment for a Robin user, how to install a Helm chart that generates a Helm release suitable for registration with Robin Platform, and how to perform a Helm release registration. Note that the initial steps must be performed by a superadmin user. The remaining steps are to be performed by the Robin Platform user.
The following example assumes superadmin user admin is setting up the Helm environment for Robin Platform user user1 who is a member of Tenant t1.
Log in as the superadmin user:
# robin login admin
Password: <admin_password>
User admin is logged into Administrators tenant
Generate a list of Robin Platform users:
# robin user list
ID | Username | Full Name | Email | Tenants | Current Tenant | Current Role | Current Namespace | Authentication
---+----------+---------------+-------+----------------+----------------+--------------+-------------------+----------------
3 | admin | Robin Systems | | Administrators | Administrators | superadmin | t001-u000003 | local
4 | user1 | | | t1 | t1 | user | t003-u000004 | local
Note the Current Namespace for user1: t003-u000004
Deploy Tiller objects for user1’s assigned namespace:
The following command creates a number of Kubernetes resources (tiller ServiceAccount and RoleBinding) that will be needed by Tiller when it gets deployed into the user’s assigned namespace.
# robin k8s deploy-tiller-objects t003-u000004
Tiller objects were successfully deployed for namespace 't003-u000004'
Log in as user1:
# robin login user1
Password: <user1_password>
User user1 is logged into t1 tenant
Get the current user context for user1:
The robin whoami command returns useful information about the
current Robin Platform user. It includes a list of tenants the user is a
member of (user1 is only a member of one tenant) and which tenant
they are currently logged into. Additionally, the whoami output
includes the Kubernetes namespace that has been assigned to the user
for their current tenant. This is the namespace the Helm chart needs
to be installed into.
# robin whoami
username: user1
tenant: t1
tenants: ['t1']
namespace: t003-u000004
session_expires: 2020-01-24T11:53:02
Set up Helm and deploy Tiller in user1’s assigned namespace:
The following command sets up Helm for use by the current Robin Platform user (user1). It first copies the CA cert and the user’s cert and key into the .helm directory in the user’s HOME directory. It then issues a ‘helm2 init’ command to deploy Tiller into the user’s assigned namespace.
# robin k8s helm-setup t003-u000004
Helm initialized successfully
Wait for Tiller to be deployed:
# helm2 list --tls --tiller-namespace=t003-u000004
Error: could not find tiller
Repeat the above command until no errors are returned
Add the stable Helm repo for the current user:
# helm2 repo add stable https://kubernetes-charts.storage.googleapis.com
"stable" has been added to your repositories
Install the stable/mysql Helm chart:
With respect to the helm2 command line below, note that
persistence.storageClass is set equal to ‘robin’. Using Robin
Storage is a requirement for Helm release registration with Robin
Platform. Also note the inclusion of the current user’s assigned
namespace in two places in the Helm command line. The --namespace
parameter specifies which Kubernetes namespace the application
resources will be bound to. The --tiller-namespace parameter
tells Helm which namespace Tiller has been deployed to. The namespace
for both parameters must be the same and it must be the namespace
assigned to the user by Robin Platform.
# helm install stable/mysql --tls --set persistence.storageClass=robin --namespace t003-u000004 --tiller-namespace=t003-u000004
NAME: billowing-tortoise
LAST DEPLOYED: Wed Jan 22 21:55:24 2020
NAMESPACE: t003-u000004
STATUS: DEPLOYED
RESOURCES:
==> v1/ConfigMap
NAME AGE
billowing-tortoise-mysql-test 0s
==> v1/Deployment
NAME AGE
billowing-tortoise-mysql 0s
==> v1/PersistentVolumeClaim
NAME AGE
billowing-tortoise-mysql 0s
==> v1/Pod(related)
NAME AGE
billowing-tortoise-mysql-d4f976d96-89x5c 0s
==> v1/Secret
NAME AGE
billowing-tortoise-mysql 0s
==> v1/Service
NAME AGE
billowing-tortoise-mysql 0s
NOTES:
MySQL can be accessed via port 3306 on the following DNS name from within your cluster:
billowing-tortoise-mysql.t003-u000004.svc.cluster.local
To get your root password run:
MYSQL_ROOT_PASSWORD=$(kubectl get secret --namespace t003-u000004 billowing-tortoise-mysql -o jsonpath="{.data.mysql-root-password}" | base64 --decode; echo)
To connect to your database:
1. Run an Ubuntu pod that you can use as a client:
kubectl run -i --tty ubuntu --image=ubuntu:16.04 --restart=Never -- bash -il
2. Install the mysql client:
$ apt-get update && apt-get install mysql-client -y
3. Connect using the mysql cli, then provide your password:
$ mysql -h billowing-tortoise-mysql -p
To connect to your database directly from outside the K8s cluster:
MYSQL_HOST=127.0.0.1
MYSQL_PORT=3306
# Execute the following command to route the connection:
kubectl port-forward svc/billowing-tortoise-mysql 3306
mysql -h ${MYSQL_HOST} -P${MYSQL_PORT} -u root -p${MYSQL_ROOT_PASSWORD}
Get the Helm release name:
Note that the --tls flag is required for all Helm commands
because Helm and Tiller were configured to require the user’s TLS
cert and key (coped to the .helm directory in a previous step).
# helm list --tls --tiller-namespace=t003-u000004
NAME REVISION UPDATED STATUS CHART APP VERSION NAMESPACE
billowing-tortoise 1 Wed Jan 22 21:55:24 2020 DEPLOYED mysql-1.6.2 5.7.28 t003-u000004
Manually register Helm release as a HELM Application:
# robin app register mysql --app helm/billowing-tortoise -n t003-u000004
Job: 114 Name: K8SAppRegister State: PREPARED Error: 0
Job: 114 Name: K8SAppRegister State: COMPLETED Error: 0
Get a listing of all Robin Platform applications:
Note that the Robin Platform CLI command to list applications returns two application groupings. It returns a list of applications that were deployed by Robin Platform from Application Bundles. It will also include a list of applications that were registered with the cluster (Helm releases and FlexApps).
Also note that RBAC control limits which applications a user is able to view. A user who has been assigned the user role (user1 in this example) will only be able to view applications they own (created/registered). A user who has been assigned the tenantadmin role will be able to view all applications created/registered by all members of their tenant. A user who has been assigned the superadmin role (admin in this example) will be able to see all applications created/registered by all users across the entire cluster (e.g., for all tenants). Note that a user can only be superadmin if they are logged into the Administrators tenant.
# robin app list
ROBIN Bundle Apps:
+-------+--------------+--------+--------+---------------+--------+-----+-----+-------------+--------+---------+-----------+-------+
| Name | Owner/Tenant | Type | Parent | Resource Pool | Vnodes | CPU | GPU | Memory (GB) | Status | LastOpr | Health | Error |
+-------+--------------+--------+--------+---------------+--------+-----+-----+-------------+--------+---------+-----------+-------+
+-------+--------------+--------+--------+---------------+--------+-----+-----+-------------+--------+---------+-----------+-------+
Helm/Flex Apps:
+--------+------+--------+--------------+--------------+-----------+---------+
| Name | Type | State | Owner/Tenant | Namespace | Snapshots | Backups |
+--------+------+--------+--------------+--------------+-----------+---------+
| mysql | helm | ONLINE | user1/t1 | t003-u000004 | 0 | 0 |
+--------+------+--------+--------------+--------------+-----------+---------+
Get detailed information about the resulting application:
# robin app info mysql
Name : mysql
Kind : helm
State : ONLINE
Number of repos : 0
Number of snapshots : 0
Number of usable backups : 0
Number of archived/failed backups : 0
Query:
-------
{'namespace': 't003-u000004', 'apps': ['helm/billowing-tortoise'], 'resources': [], 'selectors': []}
10.5. Robin FlexApp Applications¶
Robin Platform provides a very flexible mechanism for registering any
set of Kubernetes resources as a Robin Application. The FlexApp
construct uses label selector rules to group the resources together.
For example, --select app=apache --select app=mysql would select
Pods and PVCs for a web and database tier together into a single
FlexApp object. To create a FlexApp, use this command:
# robin app register <app-name>
--selector <label-name>=<label-value>
--resource <resource-type>/<resource-name>
--namespace <namespace>
--dry-run
|
Name to assign to FlexApp |
|
Resources with these Kubernetes labels would be selected to be part of this FlexApp |
|
Resources of the specified type and name would be selected to be part of this FlexApp |
|
Namespace in which the Kubernetes resources are deployed. |
|
Using this option would display the kind, name and status of the objects to be picked up. Note, this will not register the application. |
Selecting resources that have more than one matching label (AND condition):
This is achieved by comma-seperating label name=value pairs as
follows: --select tier=frontend,env=dev will select resources
that have both tier = frontend AND env = dev labels on it.
Selecting resources that have at least one of the matching labels (OR condition):
This is achieved by specifying the --select option multiple times.
For example: --select env=dev --select env=prod will select any
resource that has either env = dev or env = prod labels on
it.
Selecting resources of a certain type with matching labels:
Let’s say one wants to select only PersistentVolumeClaims and
StatefulSelect type resources with matching labels. That is, any
other resource with a matching label should not be selected. This is
achieved by specifying the resource name as a prefix to the label
name as follows: --select pvc,statefulset:tier=database
Explicitly selecting certain resources:
The --resource option is used to specify explicitly which
Kubernetes resources are to be made part of the FlexApp. The format
to specify this is as follows: --resource
<resource-type>/<resource-name>, where <resource-name> is any
of the resources (“Kind”) that the Kubernetes cluster recognizes,
such as PersistentVolumeClaims (pvc), StatefulSets, Services, etc.
Running
kubectl api-resourceswould list all valid values of<resource-type>Running
kubectl get <resource-type>would list all valid<resource-name>of that specific resource type
10.6. Create an Application¶
Robin supports the creation of applications from a number of sources:
from-bundle |
Create an application from a ROBIN Application Bundle or Helm Bundle |
from-snapshot |
Create a clone of an existing application from one of the application’s snapshots |
from-backup |
Create a new application instance from an application backup |
10.6.1. Create an application from a Bundle¶
An application instance can be created from either Robin Application or Helm based Bundle with the following command:
# robin app create from-bundle <app_name> <bundleid> [<template>]
--rpool <rpool_name>
--ip-pools <ip_pools>
--restart-attempts <restart_num>
--namespace <namespace>
--disable-hooks
--disable-auto-relocate
--genplan
|
Application instance name |
|
Unique ID of the Application Bundle |
|
For Robin Bundle based applications the template name or pathname of template file can be specified. If not specified the default template generated from the bundle manifest will be used. For Helm based bundles, this parameter should point to the |
|
Name of the resource pool to use. This is a mandatory parameter for Robin Application Bundle based applications |
|
Name of IP pools from which to allocated IP addresses for the application |
|
Number of restart attempts when the app is in a failed state |
|
Kubernetes namespace in which the application will be deployed. If not specified, the application will be deployed within the users current namespace |
|
Disable hook scripts such that they do not run |
|
Disable auto relocate upon failure |
|
Only generate a plan for an application instead of deploying it |
Note
The following parameters are only applicable to Robin Application Bundle based applications: --rpool, --ip-pools, --restart-attempts, --disable-hooks, --disable-auto-relocate, and --genplan.
Example 1 (Creating a Robin Application Bundle based application):
# robin app create from-bundle mysql-a 1 mysql_template.json --rpool default --wait
Job: 178 Name: ApplicationCreate State: VALIDATED Error: 0
Job: 178 Name: ApplicationCreate State: WAITING Error: 0
Job: 178 Name: ApplicationCreate State: COMPLETED Error: 0
Example 2 (Creating a Helm bundle based application):
# robin app create from-bundle mysql-hb1 3 --wait
Job: 105 Name: K8SApplicationCreateHelm State: VALIDATED Error: 0
Job: 105 Name: K8SApplicationCreateHelm State: WAITING Error: 0
Job: 105 Name: K8SApplicationCreateHelm State: COMPLETED Error: 0
Creates an application instance from a Bundle.
End Point: /api/v3/robin_server/apps
Method: POST
URL Parameters: None
Data Parameters:
kind: ROBIN- This mandatory field within the payload specifies that a Robin Bundle based application is to be created.name: <app_name>- This mandatory field within the payload specifies the name of the application to be created.bundleid: <bundle_id>- This mandatory field within the payload specifies the ID of the bundle from which the application will be created.rpool: <rpool_name>- This mandatory field within the payload specifies the name of the resource pool in which the application will be created.template_json: <template>- Utilizing this parameter within the payload, by specifying a dictionary representing the template in JSON format, results in the provided template and the parameters contained within it being used when the application is deployed. For Helm based bundles, this should be the JSON equivalent of thevalues.yamlfile for the chart. In order to indicate that the implicitly generated default template or default values of the bundle should be used specify an empty dictionary.template: <template_name>- Utilizing this parameter within the payload, by specifying a string representing a template name, results in the template associated with the name being used during application deployment.ip_pools: <list_of_ippools>- Utilizing this parameter within the payload, by specifying a comma seperated list of IP Pool names, results in an IP address being allocated from each specified IP Pool for the application.namespace: <namespace>- Utilizing this parameter within the payload, by specifying a string representing a namespace name, results in the application being deployed in the aforementioned namespace. If not specified, the application will be deployed within the users current namespace.restart_num: <restart_num>- Utilizing this parameter within the payload, by specifying an integer, results in the number of restart attempts in the case of application failure being set to the specified value. The default value is 15.auto_relocate: true- Utilizing this parameter within the payload, by specifying a boolean value, determines whether or not the auto relocate functionality is enabled for the application in the case of failure. By default it is enabled.disable_hooks: true- Utilizing this parameter within the payload, by specifying a boolean value, determines whether or not the hook scripts are enabled to be run during life cycle operations. By default hook scripts are enabled.genplan: true- Utilizing this parameter within the payload results in only a plan being generated and returned for the application instead of an actual deployment taking place.
Note
The following parameters are only applicable to Robin Application Bundle based applications: rpool, template, ip_pools, restart_num, disable_hooks, auto_relocate, and genplan.
Port: RCM Port (default value is 29442)
Headers:
Authorization: <auth_token>: Authorization token to identify which user is sending the request. The token can be acquired from the login API.
Success Response Code: 202
Error Response Code: 500 (Internal Server Error), 401 (Unauthorized Error), 400 (Invalid API Usage Error), 409 (Duplicate Resource Error)
Example Response:
Output
{
"plan":{
"enable_hooklogs":true,
"zoneid":1599768542,
"from_template":null,
"input_json":{
},
"roles":[
{
"multinode":true,
"restart_on_qoscfg":true,
"vnodes":[
{
"enable_hooklogs":true,
"enable_metrics":true,
"env":{
"ENABLE_SSH":{
"type":"boolean",
"value":true
},
"ROOT_PASSWORD":{
"type":"password",
"value":""
},
"DOCKER_OPTS":{
"type":"text",
"value":"-v \/sys\/fs\/cgroup:\/sys\/fs\/cgroup --cap-add=SYS_ADMIN"
}
},
"cpu":{
"min":0,
"reserve":false,
"max":1
},
"name":"demo-test.server.01",
"multinode":true,
"vnodehooks":{
"postcreate":"bash postcreate.sh"
},
"gpu":{
"min":0,
"max":0
},
"mem":{
"hugepages_2m":0,
"size":209715200,
"hugepages_1g":0
},
"network":[
{
"ippool":"robin-default",
"name":"robin-default"
}
],
"enable_portmapping":true,
"storage":[
{
"compression":"disabled",
"stordriver":{
"media":"SSD",
"protection":0,
"faultdomain":"host",
"type":"das"
},
"disk_tags":{
},
"faultdomain":"host",
"workload":0,
"type":"data",
"pvcpolicy":"create",
"snapshot_space_limit":214748365,
"size":1073741824,
"replication":1,
"fstype":"ext4",
"media":"SSD",
"lvm_vol_count":"0",
"name":"none_server01_data01",
"snap_reserved":20,
"encryption":"none",
"blocksize":4096,
"protection":0,
"lvm_type":"None",
"layout":"round-robin",
"path":"\/data"
},
{
"compression":"disabled",
"stordriver":{
"media":"SSD",
"protection":0,
"faultdomain":"host",
"type":"das"
},
"disk_tags":{
},
"faultdomain":"host",
"workload":0,
"type":"block",
"pvcpolicy":"create",
"snapshot_space_limit":214748365,
"size":1073741824,
"replication":1,
"fstype":"raw",
"media":"SSD",
"lvm_vol_count":"0",
"name":"none_server01_block01",
"snap_reserved":20,
"encryption":"none",
"blocksize":4096,
"protection":0,
"lvm_type":"None",
"layout":"round-robin",
"path":"\/dev\/rda"
}
]
}
],
"image":{
"entrypoint":"entry.sh",
"name":"robinsys\/centos",
"init_mode":false,
"version":"7",
"engine":"docker"
},
"name":"server",
"display_name":"server",
"qgroups":{
"data":{
"wr_min_window":500,
"enabled":false,
"wr_weight":1,
"rd_weight":1,
"rd_min_iops":0,
"rd_min_window":500,
"wr_min_iops":0,
"wr_max_iops":2000000,
"priority":1,
"rd_max_iops":2000000
},
"block":{
"wr_min_window":500,
"enabled":false,
"wr_weight":1,
"rd_weight":1,
"rd_min_iops":0,
"rd_min_window":500,
"wr_min_iops":0,
"wr_max_iops":2000000,
"priority":1,
"rd_max_iops":2000000
}
}
}
],
"kind":"ROBIN",
"rpool":"default",
"name":"demo-test",
"content_id":"2de2c0c8a93db5b68943f85c8b382e46",
"snapshot":"enabled",
"pvcpolicy":"create",
"robin_version":"5.3.0-225",
"enable_metrics":true,
"rpoolid":1,
"version":"7",
"restart_num":15,
"auto_relocate":true,
"namespace":"random",
"tenant":"Administrators",
"username":"robin",
"bundleid":"1",
"app_ns":"random",
"clone":"enabled"
},
"jobid":547
}
10.6.2. Create an application from a snapshot¶
In addition to providing for disaster recovery, application snapshots allow for the creation of an exact copy, or clone of an application instance. Creating a clone of an existing application instance can be very useful. For example, it allows for reports to be run on a database without affecting the source database application, for UAT tests, for validating patches before applying them to the production database, etc.
Cloning an application has typically required significant manual or
scripting work and coordination across the storage layer and the
application metadata layer (Kubernetes Pod, StatefulSet, PVC, Service
etc). With Robin one can clone an entire application or application
stack with one single command robin app create from-snapshot. Running this
command creates a clone of an entire application from a previously
taken application snapshot. Once complete the application is ready
for use right away.
Changes made to the clone are not visible in the parent application from which the clone was created. Similarly, any changes made to the parent application are not visible to the clone. At the storage layer, Robin’s thin cloning technology is leveraged. Which means that a cloned PersistentVolume is not a physical copy of the source volume. Instead, it is a virtual copy, where only metadata is physically copied with the actual data being shared between the clone and the source. Changes made to either the clone or the source are localized into their own writable data streams, whereas any common unmodified data is shared.
A clone of an existing application instance can be created from an application snapshot with the following command:
# robin app create from-snapshot <app_name> <snapshotid>
--rpool <rpool_name>
--ip-pools <ip_pools>
--role-ip-pools <role_pools>
--role-vnode-hostnames <role_vnode_hosts>
--role-cpus <role_cpus>
--role-gpus <role_gpus>
--role-mem <role_mem>
|
Application instance name |
|
Unique ID of the application snapshot |
|
Name of the resource pool to use. This is a mandatory parameter for clones of Robin Bundle based applications and does not apply to Helm based applications |
|
Name of IP pool from which to allocate IP address of clone. This parameter only applies to clones of Robin Bundle based applications |
|
Comma separated list of IP Pools for a role in the format: |
|
Comma separated list of vnode hostnames for a role in the format: |
|
CPU count for a role in the format: |
|
GPU count for a role in the format: |
|
Memory for a role in the format: |
Note
All of the role specific parameters can be specified multiple times for different roles.
Example 1 (Create a clone of a Robin app from a snapshot):
# robin app create from-snapshot mysql-c1 ec2bdeba447211eaa2028d14cd0bbca6 --rpool default --wait
Job: 187 Name: ApplicationClone State: VALIDATED Error: 0
Job: 187 Name: ApplicationClone State: WAITING Error: 0
Job: 187 Name: ApplicationClone State: FINALIZED Error: 0
Job: 187 Name: ApplicationClone State: COMPLETED Error: 0
Example 2 (Create a clone (FLEX app) of a HELM app from a snapshot):
# robin app create from-snapshot mysql1-c1 d17d19f044ba11ea8e7831d18d69fbab --wait
Job: 198 Name: K8SApplicationClone State: PREPARED Error: 0
Job: 198 Name: K8SApplicationClone State: AGENT_WAIT Error: 0
Job: 198 Name: K8SApplicationClone State: COMPLETED Error: 0
Clones an existing application instance using a snapshot of the aformentioned application.
End Point: /api/v3/robin_server/apps/<snapshot_name>
Method: PUT
URL Parameters: None
Data Parameters:
action: clone- This mandatory field within the payload specifies that the clone operation should be performed.clonename: <app_name>- This mandatory field within the payload specifies the name of the clone to be created.rpool: <rpool_name>- This mandatory field within the payload specifies the name of the resource pool in which the clone will be created.cloneconfig: <clone_config>- This mandatory field within the payload specifies the base configuration of the clone. Within each role of the configuration one can edit thevnode_hostnamessection, and within each vnode for the role the following attributes can be updated:network, the max value ofcpu, the max value ofgpu, and the size value ofmem.
Note
The base config of the clone is the JSON spec file associated with the respective snapshot.
Port: RCM Port (default value is 29442)
Headers:
Authorization: <auth_token>: Authorization token to identify which user is sending the request. The token can be acquired from the login API.
Success Response Code: 202
Error Response Code: 500 (Internal Server Error), 401 (Unauthorized Error), 400 (Invalid API Usage Error)
Example Response:
Output
{
"plan":{
"enable_hooklogs":true,
"snapname":"snapshot-1602011804",
"zoneid":"1599768542",
"from_template":null,
"planid":6,
"app_ns":"t001-u000005",
"roles":[
{
"name":"server",
"multinode_min":1,
"qgroups":{
"data":{
"wr_min_window":500,
"enabled":false,
"wr_min_iops":0,
"wr_weight":1,
"rd_min_iops":0,
"rd_min_window":500,
"rd_weight":1,
"wr_max_iops":2000000,
"priority":1,
"rd_max_iops":2000000
},
"root_fs":{
"wr_min_window":500,
"enabled":false,
"wr_min_iops":0,
"wr_weight":1,
"rd_min_iops":0,
"rd_min_window":500,
"rd_weight":1,
"wr_max_iops":2000000,
"priority":1,
"rd_max_iops":2000000
},
"block":{
"wr_min_window":500,
"enabled":false,
"wr_min_iops":0,
"wr_weight":1,
"rd_min_iops":0,
"rd_min_window":500,
"rd_weight":1,
"wr_max_iops":2000000,
"priority":1,
"rd_max_iops":2000000
}
},
"vnodes":[
{
"enable_hooklogs":true,
"role_name":"server",
"restart_num":15,
"state":"STARTED",
"host_ip":"172.21.19.191",
"jobid":165,
"rpoolid":1,
"name":"demo-clone.server.01",
"gpu":{
"type":"",
"max":0,
"count":0
},
"hosttags":{
"robin.io\/robinrpool":[
"default"
],
"kubernetes.io\/arch":[
"amd64"
],
"kubernetes.io\/os":[
"linux"
]
},
"calico_inuse":true,
"enable_portmapping":true,
"utime":1600437863,
"bundle_path":"\/usr\/local\/robin\/collections\/file-collection-1599768866069\/1600437790650\/centos-7",
"allocated":{
"zonename":"default",
"nodename":"vnode-95-18",
"zoneid":1599768542,
"nodeid":3
},
"cpu":{
"min":0,
"max":1,
"reserve":false,
"nonisol":true
},
"cm_keys":[
"ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDSJtWucW0WsDJkGDdcov6bUGiZlPvMyREwWYS6V1H+bl1B7cql4E7KPC4A9M0TZGKpvaczcsW8wkGl1Xh70O8uVShpn45nQERLI\/P2teNB4CXhQFny1IvW3Jahv+XgvuSC9ZmoZu1E\/LPYXMsZ7CtfVzCduVtPpp7YeL8ybndPD9RuMLFWfKEKBocym7b95+2CKiNT4adQhUqMqAk4SUvLZLIWhqyFnuMnykzXrqobYKkdaRPgHf0JXYSBaqMbzwkld8UhMkv5RymueFnzsIebc0goy3MnbxEV+nVQ77BUh025jr+4MfseCSRexbedtQ3vp3ODy\/+pcU0TxqbfPuN3 root@vnode-95-42.robinsystems.com"
],
"service_ports":[
],
"bundle_object_id":"2de2c0c8a93db5b68943f85c8b382e46",
"appname":"demo",
"env":{
"ENABLE_SSH":{
"type":"boolean",
"value":true
},
"ROOT_PASSWORD":{
"type":"password",
"value":""
},
"DOCKER_OPTS":{
"type":"text",
"value":"-v \/sys\/fs\/cgroup:\/sys\/fs\/cgroup --cap-add=SYS_ADMIN"
}
},
"allocated_host_type":"physical",
"bundleid":"1",
"k8s_provider":"robin",
"vnodehookargs":{
"postcreate":[
]
},
"allocated_host_public_hostname":"vnode-95-18.robinsystems.com",
"engine":"docker",
"role":"server",
"disable_vnodehooks":false,
"enable_metrics":true,
"root_fs":"\/usr\/local\/robin\/instances\/demo-server-01.t001-u000005.svc.cluster.local",
"allocated_host_public_ip":"10.9.95.18",
"vnodehooks":{
"postcreate":"bash postcreate.sh"
},
"id":1,
"mem":{
"hugepages_2m":0,
"size":2013265920,
"hugepages_1g":0
},
"network":[
{
"name":"robin-default",
"interfaces":1,
"driver":"calico",
"allocated_prefix":16,
"allocated_names":[
"eth0"
],
"subnet":"172.21.0.0",
"allocated_ip":"172.21.19.191",
"ippool":"robin-default",
"allocated_by":"system",
"allocated_netmask":"255.255.0.0"
}
],
"appid":1,
"desired_status":"ONLINE",
"storage":[
{
"device":"\/dev\/sdc",
"volgrp_name":"demo.server.01.72.1.d98c2f1d-bed6-46a1-a1b8-5df11f5e5289",
"type":"data",
"stordriver":{
"media":"HDD",
"type":"das",
"faultdomain":"nofd",
"protection":"0"
},
"fstype":"ext4",
"media":"HDD",
"name":"demo-clone.server.01.data.1.41da8189-b80b-44e2-ab7e-19c28a9d48ef",
"snap_reserved":20,
"lvm_vol_count":"0",
"protection":0,
"pvcpolicy":"create",
"k8s_name":"demo-server-01-data-1-55121b5e",
"lvm_type":"None",
"parent_vol":{
"current_snapshot":"active_snap",
"vtype":0,
"partitions":0,
"stordriver":{
"media":"HDD",
"type":"das",
"faultdomain":"nofd",
"protection":"0"
},
"params":{
},
"name":"demo.server.01.data.1.55121b5e-ca30-47f5-9be8-3b80a2c837e1",
"block_size":4096,
"appid":1,
"protection":0,
"next_backupid":1,
"priority":2,
"resource_poolid":1,
"compression":0,
"current_snapshotid":1,
"next_snapshotid":2,
"size":1073741824,
"replication":1,
"qgroupid":3,
"appname":"default",
"slice_size":1073741824,
"snapshot_space_limit":536870912,
"snapname":"snapshot-1602011804",
"volumeid":"4",
"genkey":1600437814337784,
"media":72,
"grpid":3,
"multinode_mounting":false
},
"compression":"0",
"disk_tags":{
},
"faultdomain":"host",
"encryption":"none",
"size":1073741824,
"vol_ns":"t001-u000005",
"replication":1,
"workload":0,
"snapshot_space_limit":536870912,
"blocksize":4096,
"layout":"round-robin",
"path":"\/data",
"snapname":"snapshot-1602011804"
},
{
"device":"\/dev\/sdd",
"volgrp_name":"demo.server.01.72.1.388f1aaf-fd51-43d6-be0b-4461d5f44063",
"type":"block",
"stordriver":{
"media":"HDD",
"type":"das",
"faultdomain":"nofd",
"protection":"0"
},
"fstype":"raw",
"media":"HDD",
"name":"demo-clone.server.01.block.1.496cdedc-cd44-4984-b75f-dac9c55bea13",
"snap_reserved":20,
"lvm_vol_count":"0",
"protection":0,
"pvcpolicy":"create",
"k8s_name":"demo-server-01-block-1-cddb023c",
"lvm_type":"None",
"parent_vol":{
"current_snapshot":"active_snap",
"vtype":0,
"partitions":0,
"stordriver":{
"media":"HDD",
"type":"das",
"faultdomain":"nofd",
"protection":"0"
},
"params":{
},
"name":"demo.server.01.block.1.cddb023c-f1c4-4d1d-9973-c0548510617f",
"block_size":4096,
"appid":1,
"protection":0,
"next_backupid":1,
"priority":2,
"resource_poolid":1,
"compression":0,
"current_snapshotid":1,
"next_snapshotid":2,
"size":1073741824,
"replication":1,
"qgroupid":2,
"appname":"default",
"slice_size":1073741824,
"snapshot_space_limit":536870912,
"snapname":"snapshot-1602011804",
"volumeid":"3",
"genkey":1600437814328082,
"media":72,
"grpid":4,
"multinode_mounting":false
},
"compression":"0",
"disk_tags":{
},
"faultdomain":"host",
"encryption":"none",
"size":1073741824,
"vol_ns":"t001-u000005",
"replication":1,
"workload":0,
"snapshot_space_limit":536870912,
"blocksize":4096,
"layout":"round-robin",
"path":"\/dev\/rda",
"snapname":"snapshot-1602011804"
},
{
"device":"\/dev\/sde",
"volgrp_name":"demo.server.01.72.1.84a67da9-3839-49db-a967-0c7ed3f191d2",
"type":"root_fs",
"stordriver":{
"media":"HDD",
"type":"das",
"faultdomain":"nofd",
"protection":"0"
},
"fstype":"xfs",
"media":"HDD",
"name":"demo-clone.server.01.root_fs.1.72719c18-04f6-4f9b-b2a9-8284afa14516",
"snap_reserved":20,
"lvm_vol_count":"0",
"protection":0,
"pvcpolicy":"create",
"k8s_name":"demo-server-01-root-fs-1-03999d04",
"lvm_type":"None",
"parent_vol":{
"current_snapshot":"active_snap",
"vtype":0,
"partitions":0,
"stordriver":{
"media":"HDD",
"type":"das",
"faultdomain":"nofd",
"protection":"0"
},
"params":{
},
"name":"demo.server.01.root_fs.1.03999d04-597d-4db9-9f02-3571a816eca6",
"block_size":4096,
"appid":1,
"protection":0,
"next_backupid":1,
"priority":2,
"resource_poolid":1,
"compression":0,
"current_snapshotid":1,
"next_snapshotid":2,
"size":1073741824,
"replication":1,
"qgroupid":4,
"appname":"default",
"slice_size":1073741824,
"snapshot_space_limit":536870912,
"snapname":"snapshot-1602011804",
"volumeid":"5",
"genkey":1600437814342977,
"media":72,
"grpid":5,
"multinode_mounting":false
},
"compression":"0",
"disk_tags":{
},
"faultdomain":"host",
"encryption":"none",
"size":1073741824,
"vol_ns":"t001-u000005",
"replication":1,
"workload":0,
"snapshot_space_limit":536870912,
"blocksize":4096,
"layout":"round-robin",
"path":"\/",
"snapname":"snapshot-1602011804"
}
],
"restart_on_qoscfg":true,
"service_uids":[
],
"ctime":1600437863,
"vnodeid":1,
"image":{
"name":"robinsys\/centos",
"version":"7",
"registry_hostname":"",
"entrypoint":"entry.sh",
"registry_port":"",
"init_mode":false,
"registry_name":"Docker Hub",
"engine":"docker"
},
"allocated_host":"vnode-95-18.robinsystems.com",
"sidecar_info":{
"gpu":0,
"hugepages_2m":0,
"mem":0,
"containers":[
],
"cpu":0,
"hugepages_1g":0
}
}
],
"restart_on_qoscfg":true,
"elastic_ip_enabled":false,
"multinode_max":256,
"image":{
"name":"robinsys\/centos",
"version":"7",
"registry_hostname":"",
"entrypoint":"entry.sh",
"registry_port":"",
"init_mode":false,
"registry_name":"Docker Hub",
"engine":"docker"
},
"multinode":true,
"display_name":"server",
"scaleout":"enabled"
}
],
"local_avail":true,
"enable_metrics":true,
"stordriver":"das",
"rpool":"default",
"name":"demo-clone",
"id":1,
"namespace":"t001-u000005",
"from_backup":false,
"snapshot":"enabled",
"original_app_owner":5,
"pvcpolicy":"create",
"parent_last_known_state":6,
"content_id":"2de2c0c8a93db5b68943f85c8b382e46",
"rpoolid":1,
"bundle_path":"\/usr\/local\/robin\/collections\/file-collection-1599768866069\/1600437790650\/centos-7",
"version":"7",
"restart_num":15,
"bundle_object_id":"2de2c0c8a93db5b68943f85c8b382e46",
"auto_relocate":true,
"original_app_tenant":1,
"op_clone":true,
"clone":"enabled",
"tenant":"Administrators",
"username":"robin",
"bundleid":"1",
"master_name":"demo",
"desc":{
},
"parentid":4
},
"jobid":552
}
10.6.3. Create an application from a backup¶
A application instance can be created from an application backup with the following command:
# robin app create from-backup <app_name> <backupid>
--rpool <rpool_name>
--ip-pools <ip_pools>
--restart-attempts <restart_num>
--namespace <namespace>
--media <media>
--disable-hooks
--disable-auto-relocate
--genplan
--start-hydration
|
Application instance name |
|
Unique ID of the Application backup |
|
Name of the resource pool to use. This is a mandatory parameter for Robin Bundle based applications and is not applicable to Helm based applications |
|
Name of IP pools from which to allocated IP addresses for the imported application. Note this option is only valid for Robin Bundle based applications |
|
Number of restart attempts when the app is in a failed state. Note this option is only valid for Robin Bundle based applications |
|
Kubernetes namespace in which the application will be deployed |
|
Specify the media type to be used for the volumes of the imported app. Valid values include: ‘HDD’, ‘SSD’. Note this option is only valid for Robin Bundle based applications |
|
Disable hook scripts such that they do not run. Note this option is only valid for Robin Bundle based applications |
|
Disable auto relocate upon failure. Note this option is only valid for Robin Bundle based applications |
|
Only generate a plan for an application instead of deploying it. Note this option is only valid for Robin Bundle based applications |
Example 1 (Create a Robin app from a backup):
# robin app create from-backup mysql-b2 ee529688447211eabaf85b58e9f190fd --rpool default --wait
Job: 182 Name: ApplicationCreate State: VALIDATED Error: 0
Job: 182 Name: ApplicationCreate State: WAITING Error: 0
Job: 182 Name: ApplicationCreate State: COMPLETED Error: 0
Example 2 (Create a FLEX app from the backup of a HELM app):
# robin app create from-backup mysql1-b2 952f3738447211ea99cee7cd7390d6c9 --wait
Job: 181 Name: K8SApplicationCreate State: PREPARED Error: 0
Job: 181 Name: K8SApplicationCreate State: AGENT_WAIT Error: 0
Job: 181 Name: K8SApplicationCreate State: COMPLETED Error: 0
Imports an application instance from a backup. Note this is a two step process as outlined by the example API requests detailed below.
Retrieving the backup config
End Point: /api/v3/robin_server/storage_repo
Method: GET
URL Parameters:
sub-command: get-backup-info- This mandatory parameter within the url specifies that detailed information about the backup should be retrieved.backupid: <backupid>- This mandatory parameter within the url specifies the ID of the backup for which to retrieve the configuration of.
Data Parameters: NonePort: RCM Port (default value is 29442)
Headers:
Authorization: <auth_token>: Authorization token to identify which user is sending the request. The token can be acquired from the login API.
Success Response Code: 200Error Response Code: 500 (Internal Server Error), 401 (Unauthorized Error), 400 (Invalid API Usage Error), 404 (Not Found Error)
Example Response:
Output
{ "data":[ { "zoneid":1599768542, "bundle_name":"centos-7", "backupname":"demo_backup-1602011804", "bundle_object_id":"2de2c0c8a93db5b68943f85c8b382e46", "backup_kind":"robin-platform-backup", "size":369098752, "config":{ "enable_hooklogs":true, "parentid":1, "zoneid":"1599768542", "from_template":null, "username":"user1", "parent_last_known_state":6, "enable_metrics":true, "stordriver":"das", "rpoolid":1, "desc":{ }, "namespace":"t001-u000005", "content_id":"2de2c0c8a93db5b68943f85c8b382e46", "snapshot":"enabled", "pvcpolicy":"create", "bundle_path":"\/usr\/local\/robin\/collections\/file-collection-1599768866069\/1600437790650\/centos-7", "version":"7", "auto_relocate":true, "rpool":"default", "name":"none", "tenant":"Administrators", "app_ns":"t001-u000005", "bundleid":1, "roles":[ { "multinode_max":256, "vnodes":[ { "enable_hooklogs":true, "role_name":"server", "host_ip":"172.21.19.191", "jobid":165, "name":"demo.server.01", "calico_inuse":true, "env":{ "ENABLE_SSH":{ "type":"boolean", "value":true }, "ROOT_PASSWORD":{ "type":"password", "value":"" }, "DOCKER_OPTS":{ "type":"text", "value":"-v \/sys\/fs\/cgroup:\/sys\/fs\/cgroup --cap-add=SYS_ADMIN" } }, "service_ports":[ ], "cpu":{ "min":0, "reserve":false, "max":1, "nonisol":true }, "k8s_provider":"robin", "engine":"docker", "allocated_host_public_hostname":"vnode-95-18.robinsystems.com", "disable_vnodehooks":false, "enable_metrics":true, "allocated_host_public_ip":"10.9.95.18", "vnodehooks":{ "postcreate":"bash postcreate.sh" }, "mem":{ "hugepages_2m":0, "size":2013265920, "hugepages_1g":0 }, "network":[ { "ippool":"robin-default" } ], "enable_portmapping":true, "desired_status":"ONLINE", "storage":[ { "device":"\/dev\/sdc", "type":"data", "workload":0, "fstype":"ext4", "media":"HDD", "lvm_vol_count":"0", "name":"demo.server.01.data.1.55121b5e-ca30-47f5-9be8-3b80a2c837e1", "snap_reserved":20, "import_app":true, "stordriver":{ "media":"HDD", "type":"das", "faultdomain":"nofd", "protection":"0" }, "protection":0, "lvm_type":"None", "pvcpolicy":"create", "compression":"0", "disk_tags":{ }, "faultdomain":"host", "encryption":"none", "size":1073741824, "vol_ns":"t001-u000005", "replication":1, "import_data_source":{ "zoneid":"1599768542", "backup_path_prefix":"1599768542\/demo_1\/None", "appid":1, "blocksize":4096, "current_snapshotid":1, "volumeid":"4", "backupid":1, "appname":"default" }, "snapshot_space_limit":536870912, "blocksize":4096, "layout":"round-robin", "path":"\/data", "snapname":"snapshot-1602011804" }, { "device":"\/dev\/sdd", "type":"block", "workload":0, "fstype":"raw", "media":"HDD", "lvm_vol_count":"0", "name":"demo.server.01.block.1.cddb023c-f1c4-4d1d-9973-c0548510617f", "snap_reserved":20, "import_app":true, "stordriver":{ "media":"HDD", "type":"das", "faultdomain":"nofd", "protection":"0" }, "protection":0, "lvm_type":"None", "pvcpolicy":"create", "compression":"0", "disk_tags":{ }, "faultdomain":"host", "encryption":"none", "size":1073741824, "vol_ns":"t001-u000005", "replication":1, "import_data_source":{ "zoneid":"1599768542", "backup_path_prefix":"1599768542\/demo_1\/None", "appid":1, "blocksize":4096, "current_snapshotid":1, "volumeid":"3", "backupid":1, "appname":"default" }, "snapshot_space_limit":536870912, "blocksize":4096, "layout":"round-robin", "path":"\/dev\/rda", "snapname":"snapshot-1602011804" }, { "device":"\/dev\/sde", "type":"root_fs", "workload":0, "fstype":"xfs", "media":"HDD", "lvm_vol_count":"0", "name":"demo.server.01.root_fs.1.03999d04-597d-4db9-9f02-3571a816eca6", "snap_reserved":20, "import_app":true, "stordriver":{ "media":"HDD", "type":"das", "faultdomain":"nofd", "protection":"0" }, "protection":0, "lvm_type":"None", "pvcpolicy":"create", "compression":"0", "disk_tags":{ }, "faultdomain":"host", "encryption":"none", "size":1073741824, "vol_ns":"t001-u000005", "replication":1, "import_data_source":{ "zoneid":"1599768542", "backup_path_prefix":"1599768542\/demo_1\/None", "appid":1, "blocksize":4096, "current_snapshotid":1, "volumeid":"5", "backupid":1, "appname":"default" }, "snapshot_space_limit":536870912, "blocksize":4096, "layout":"round-robin", "path":"\/", "snapname":"snapshot-1602011804" } ], "restart_on_qoscfg":true, "service_uids":[ ], "gpu":{ "type":"", "max":0, "count":0 }, "sidecar_info":{ "gpu":0, "hugepages_2m":0, "mem":0, "containers":[ ], "cpu":0, "hugepages_1g":0 } } ], "volume_groups":[ ], "multinode_min":1, "image":{ "name":"robinsys\/centos", "version":"7", "registry_hostname":"", "entrypoint":"entry.sh", "engine":"docker", "init_mode":false, "registry_name":"Docker Hub", "registry_port":"" }, "name":"server", "display_name":"server", "multinode":true, "scaleout":"enabled", "elastic_ip_enabled":false, "restart_on_qoscfg":true, "qgroups":{ "data":{ "wr_min_window":500, "enabled":false, "wr_weight":1, "rd_min_iops":0, "wr_max_iops":2000000, "rd_weight":1, "wr_min_iops":0, "rd_min_window":500, "priority":1, "rd_max_iops":2000000 }, "root_fs":{ "wr_min_window":500, "enabled":false, "wr_weight":1, "rd_min_iops":0, "wr_max_iops":2000000, "rd_weight":1, "wr_min_iops":0, "rd_min_window":500, "priority":1, "rd_max_iops":2000000 }, "block":{ "wr_min_window":500, "enabled":false, "wr_weight":1, "rd_min_iops":0, "wr_max_iops":2000000, "rd_weight":1, "wr_min_iops":0, "rd_min_window":500, "priority":1, "rd_max_iops":2000000 } } } ], "master_name":"demo", "clone":"enabled", "snapname":"snapshot-1602011804" }, "repo_name":"demo-backup", "appname":"demo" } ] }Note
The
configsection within the above detailed response will be used when creating the application.Creating the application
End Point: /api/v3/robin_server/apps
Method: POST
URL Parameters: None
Data Parameters:
name: <app_name>- This mandatory field within the payload specifies the name of the application to be created.rpool: <rpool_name>- This mandatory field within the payload specifies the name of the resource pool in which the application will be created.ip_pools: <list_of_ippools>- Utilizing this parameter within the payload, by specifying a comma seperated list of IP Pool names, results in an IP address being allocated from each specified IP Pool for the application.namespace: <namespace>- Utilizing this parameter within the payload, by specifying a string representing a namespace name, results in the application being deployed in the aforementioned namespace. If not specified, the application will be deployed within the users current namespace.restart_num: <restart_num>- Utilizing this parameter within the payload, by specifying an integer, results in the number of restart attempts in the case of application failure being set to the specified value. The default value is 15.auto_relocate: false- Utilizing this parameter within the payload, by specifying a boolean value, determines whether or not the auto relocate functionality is enabled for the application in the case of failure. By default it is enabled.disable_hooks: true- Utilizing this parameter within the payload, by specifying a boolean value, determines whether or not the hook scripts are enabled to be run during life cycle operations. By default hook scripts are enabled.genplan: true- Utilizing this parameter within the payload results in only a plan being generated and returned for the application instead of an actual deployment taking place.
Note
The main body of the request should be the config of the respective backup with the above parameters updated within the dictionary.
Port: RCM Port (default value is 29442)
Headers:
Authorization: <auth_token>: Authorization token to identify which user is sending the request. The token can be acquired from the login API.
Success Response Code: 202Error Response Code: 500 (Internal Server Error), 401 (Unauthorized Error), 400 (Invalid API Usage Error), 409 (Duplicate Resource Error)
Example Response:
Output
{ "plan":{ "enable_hooklogs":true, "repo_name":"demo-backup", "from_template":null, "app_ns":"random", "roles":[ { "multinode_max":256, "vnodes":[ { "enable_hooklogs":true, "host_ip":"172.21.19.191", "calico_inuse":true, "disable_vnodehooks":false, "enable_metrics":true, "jobid":165, "allocated_host_public_ip":"10.9.95.18", "vnodehooks":{ "postcreate":"bash postcreate.sh" }, "gpu":{ "type":"", "max":0, "count":0 }, "sidecar_info":{ "gpu":0, "hugepages_2m":0, "mem":0, "containers":[ ], "cpu":0, "hugepages_1g":0 }, "network":[ { "ippool":"robin-default", "name":"robin-default" } ], "enable_portmapping":true, "desired_status":"ONLINE", "storage":[ { "device":"\/dev\/sdc", "compression":"0", "type":"data", "workload":0, "fstype":"ext4", "media":"HDD", "lvm_vol_count":"0", "name":"demo-backup.server.data.1.b8eb9993-eba6-4f1d-af2c-fa358d9aa072", "import_app":true, "protection":0, "lvm_type":"None", "pvcpolicy":"create", "snap_reserved":20, "stordriver":{ "media":"HDD", "protection":"0", "faultdomain":"nofd", "type":"das" }, "disk_tags":{ }, "faultdomain":"host", "encryption":"none", "size":1073741824, "blocksize":4096, "vol_ns":"t001-u000005", "replication":1, "snapshot_space_limit":536870912, "import_data_source":{ "zoneid":"1599768542", "backupid":1, "appid":1, "blocksize":4096, "current_snapshotid":1, "volumeid":"4", "backup_path_prefix":"1599768542\/demo_1\/7e5ff5e4080811eba645317fc88a69a0", "appname":"default" }, "layout":"round-robin", "path":"\/data", "snapname":"snapshot-1602011804" }, { "device":"\/dev\/sdd", "compression":"0", "type":"block", "workload":0, "fstype":"raw", "media":"HDD", "lvm_vol_count":"0", "name":"demo-backup.server.block.1.54037c86-96c0-4d60-8c47-279c87afe957", "import_app":true, "protection":0, "lvm_type":"None", "pvcpolicy":"create", "snap_reserved":20, "stordriver":{ "media":"HDD", "protection":"0", "faultdomain":"nofd", "type":"das" }, "disk_tags":{ }, "faultdomain":"host", "encryption":"none", "size":1073741824, "blocksize":4096, "vol_ns":"t001-u000005", "replication":1, "snapshot_space_limit":536870912, "import_data_source":{ "zoneid":"1599768542", "backupid":1, "appid":1, "blocksize":4096, "current_snapshotid":1, "volumeid":"3", "backup_path_prefix":"1599768542\/demo_1\/7e5ff5e4080811eba645317fc88a69a0", "appname":"default" }, "layout":"round-robin", "path":"\/dev\/rda", "snapname":"snapshot-1602011804" }, { "device":"\/dev\/sde", "compression":"0", "type":"root_fs", "workload":0, "fstype":"xfs", "media":"HDD", "lvm_vol_count":"0", "name":"demo-backup.server.root_fs.1.3be39c61-ce26-424b-b0b2-a6baddeb6065", "import_app":true, "protection":0, "lvm_type":"None", "pvcpolicy":"create", "snap_reserved":20, "stordriver":{ "media":"HDD", "protection":"0", "faultdomain":"nofd", "type":"das" }, "disk_tags":{ }, "faultdomain":"host", "encryption":"none", "size":1073741824, "blocksize":4096, "vol_ns":"t001-u000005", "replication":1, "snapshot_space_limit":536870912, "import_data_source":{ "zoneid":"1599768542", "backupid":1, "appid":1, "blocksize":4096, "current_snapshotid":1, "volumeid":"5", "backup_path_prefix":"1599768542\/demo_1\/7e5ff5e4080811eba645317fc88a69a0", "appname":"default" }, "layout":"round-robin", "path":"\/", "snapname":"snapshot-1602011804" } ], "service_ports":[ ], "service_uids":[ ], "cpu":{ "min":0, "reserve":false, "max":1, "nonisol":true }, "restart_on_qoscfg":true, "mem":{ "hugepages_2m":0, "size":2013265920, "hugepages_1g":0 }, "role_name":"server", "name":"demo-backup.server.01", "env":{ "ENABLE_SSH":{ "type":"boolean", "value":true }, "ROOT_PASSWORD":{ "type":"password", "value":"" }, "DOCKER_OPTS":{ "type":"text", "value":"-v \/sys\/fs\/cgroup:\/sys\/fs\/cgroup --cap-add=SYS_ADMIN" } }, "k8s_provider":"robin", "allocated_host_public_hostname":"vnode-95-18.robinsystems.com", "engine":"docker" } ], "volume_groups":[ ], "name":"server", "multinode_min":1, "image":{ "name":"robinsys\/centos", "version":"7", "registry_hostname":"", "entrypoint":"entry.sh", "engine":"docker", "init_mode":false, "registry_name":"Docker Hub", "registry_port":"" }, "multinode":true, "display_name":"server", "scaleout":"enabled", "elastic_ip_enabled":false, "restart_on_qoscfg":true, "qgroups":{ "data":{ "wr_min_window":500, "enabled":false, "wr_min_iops":0, "wr_weight":1, "rd_weight":1, "rd_min_window":500, "rd_min_iops":0, "wr_max_iops":2000000, "priority":1, "rd_max_iops":2000000 }, "root_fs":{ "wr_min_window":500, "enabled":false, "wr_min_iops":0, "wr_weight":1, "rd_weight":1, "rd_min_window":500, "rd_min_iops":0, "wr_max_iops":2000000, "priority":1, "rd_max_iops":2000000 }, "block":{ "wr_min_window":500, "enabled":false, "wr_min_iops":0, "wr_weight":1, "rd_weight":1, "rd_min_window":500, "rd_min_iops":0, "wr_max_iops":2000000, "priority":1, "rd_max_iops":2000000 } } } ], "enable_metrics":true, "stordriver":"das", "rpoolid":1, "namespace":"random", "zoneid":1599768542, "parentid":1, "snapshot":"enabled", "pvcpolicy":"create", "content_id":"2de2c0c8a93db5b68943f85c8b382e46", "bundle_path":"\/usr\/local\/robin\/collections\/file-collection-1599768866069\/1600437790650\/centos-7", "version":"7", "restart_num":15, "auto_relocate":true, "parent_last_known_state":6, "name":"demo-backup", "clone":"enabled", "tenant":"Administrators", "username":"robin", "rpool":"default", "bundleid":1, "master_name":"demo", "desc":{ }, "snapname":"snapshot-1602011804" }, "jobid":556 }
10.7. Register a Stateful Application¶
Run this command to register a stateful application with Robin Platform:
# robin app register <appname>
--app <stateful_app>
--resource <resource>
--selector <selector>
--namespace <namespace>
--dry-run
--specs
|
The name to assign to this app in Robin Platform. To make it easy to associate with a specific Helm release that this app refers to, it is best to use a name that matches the helm release name |
|
Helm or operator based applications. Ex: helm/<release_name> |
|
Kubernetes native objects. Ex: pvc/<name> or pod/<name> |
|
Kubernetes selectors. Ex: release=mongo-1.0,heritage=tiller |
|
Kubernetes namespace in which the application exists |
|
Show the kind, name and status of the objects to be picked up. Note this will not register the application |
|
Show the spec files of the objects to be picked up. Note this will not register the application |
Note
Only one of the --describe and --dry_run options can be specified at a time.
Example 1 (Install Helm chart stable/postgresql and register the resulting Helm release):
# helm install --tls --name pgsql stable/postgresql --set persistence.storageClass=robin --namespace t003-u000004 --tiller-namespace t003-u000004
# robin app register pgsql --app helm/pgsql --namespace t003-u000004
Note
More than one helm release can be tracked in a single app by
specifying --app command line option twice. For example, $
robin app register myblog --app helm/apache --app helm/mysql
would track two different helm releases – (1) apache and (2)
mysql as a single unit named myblog in Robin Platform.
Register a stateful application with Robin Platform.
End Point: /api/v3/robin_server/k8s_app
Method: PUT
URL Parameters: None
Data Parameters:
action: register- This mandatory field within the payload specifies that the register operation is to be performed.name: <app_name>- This mandatory field within the payload specifies the name of the application to be registered.namespace: <namespace>- This mandatory field within the payload specifies the namespace in which the underlying Kubernetes objects for the application are spawned.app_type: operator- This mandatory field within the payload specifies the type of application being registered.describe: true- Utilizing this parameter results in the spec files of the objects to be picked up being returned. Note this will not register the application.dry_run: true- Utilizing this parameter results in the kind, name and status of the objects to be picked up being returned. Note this will not register the application.query: <dict_of_query_params>– This mandatory field within the payload specifies the set of query parameters to use when discovering Kubernetes objects to register as part of the applicationselectors: <list_of_selectors>- This mandatory field within the dictionary specifies a list of strings representing a group of specific Kubernetes resources in the format ‘<resource-type>/<resource-name>’ to be registered. To indicate no resources, specify an empty list.selectors: <list_of_selectors>- This mandatory field within the dictionary specifies a list of strings representing a set of selectors in the format ‘<label-name>=<label-value>’ to query Kubernetes objects with. To indicate no selectors, specify an empty list.apps: <list_of_helm_releases>- This mandatory field within the dictionary specifies a list of strings in the format ‘helm/<release_name>’ and represents the helm charts to register as part of the application. To indicate no Helm releases, specify an empty list.namespace: <namespace>- This mandatory field within the dictionary specifies the namespace in which the underlying Kubernetes objects for the application are spawned.
Note
Only one of the describe and dry_run parameters can be specified at a time.
Port: RCM Port (default value is 29442)
Headers:
Authorization: <auth_token>: Authorization token to identify which user is sending the request. The token can be acquired from the login API.
Success Response Code: 202
Error Response Code: 500 (Internal Server Error), 401 (Unauthorized Error), 400 (Invalid API Usage Error)
Example Response:
Output
{
"jobid":248
}
10.8. Unregister a Stateful Application¶
Issue the following command to unregister a stateful application from Robin Platform:
# robin app unregister <appname>
|
The name of a previously registered stateful application. |
Example:
# robin app unregister mysql1 --wait
This will remove application 'mysql1' from the cluster. Do you want to continue [y/n] ? y
Job: 169 Name: K8SAppUnregister State: PROCESSED Error: 0
Job: 169 Name: K8SAppUnregister State: COMPLETED Error: 0
Note
If the app being unregistered is a Helm release previously registered on the Robin Platform cluster, it will only be removed from the cluster. The underlying Helm release will be left intact.
Unregister a stateful application from Robin Platform.
End Point: /api/v3/robin_server/k8s_app
Method: PUT
URL Parameters: None
Data Parameters:
action: unregister- This mandatory field within the payload specifies that the unregister operation is to be performed.name: <app_name>- This mandatory field within the payload specifies the name of the application to be unregistered.
Port: RCM Port (default value is 29442)
Headers:
Authorization: <auth_token>: Authorization token to identify which user is sending the request. The token can be acquired from the login API.
Success Response Code: 202
Error Response Code: 500 (Internal Server Error), 404 (Not Found Error), 401 (Unauthorized Error), 400 (Invalid API Usage Error)
Example Response:
Output
{
"jobid":178
}
10.9. Delete an Application¶
Issue the following command to delete an application from a Robin Platform cluster:
# robin app delete <appname>
--force
|
Application instance name |
|
Force the deletion of the application and all associated Kubernetes objects. |
When you run the robin app delete --force <k8s_app/helm_app> command, starting from Robin 5.3.5 HF3 runs a new
job: K8SVolumeDeleteHelmRelease to reclaim storage space after the K8SApplicationDeleteHelm job.
Example:
# robin app delete mysql1 --wait -y
Job: 153 Name: K8SApplicationDeleteHelm State: VALIDATED Error: 0
Job: 153 Name: K8SApplicationDeleteHelm State: COMPLETED Error: 0
Note
An application that was created from a Robin Bundle can be
deleted in its entirety. That means that all of the objects
associated with the application that were created in the
Kubernetes cluster will be deleted along with the application
instance record in the Robin Platform cluster. By default, robin
app delete will fail, however, for any stateful application that
was registered with Robin Platform. To override this behavior,
include --force on the command line. If the desire is to
remove the application from Robin Platform but leave the
Kubernetes objects intact, then use the robin app unregister
command.
Delete an application from a Robin Platform cluster
End Point: /api/v6/robin_server/apps/<app_name>
Method: DELETE
URL Parameters:
force=true: Utilizing this parameter results in the ungraceful termination of an application, which includes not running any relevant hook scripts.del_snaps=true: Utilizing this parameter results in both the application and its associated snapshots being deleted.
Data Parameters: None
Port: RCM Port (default value is 29442)
Headers:
Authorization: <auth_token>: Authorization token to identify which user is sending the request. The token can be acquired from the login API.
Success Response Code: 202
Error Response Code: 500 (Internal Server Error), 404 (Not Found Error), 401 (Unauthorized Error), 400 (Invalid API Usage Error)
Example Response:
Output
{
"plan":{
"enable_metrics":true,
"auto_relocate":true,
"pvcpolicy":"create",
"enable_hooklogs":true,
"zoneid":1597147518,
"planid":710,
"content_id":"64495e524cbc9f133d4b92bcc04e1f94",
"name":"test-ds-1",
"roles":[
{
"name":"server",
"volume_groups":[
],
"vnodes":[
{
"allocated_host":"cscale-82-140.robinsystems.com",
"cm_keys":[
"ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDN8WYsAfs0+a1zzAIWIVV5MrZUaur688E08BL7fm+1uBFjBRPEevwrYrNFL7ebjJxYuB1R3WR+IX8Mmz7CiMDvfEiAQL1Ihj4GZ32WSqzZ7MN15UJK4DQWY7sU++VIusyPUj5goVS2mPj0k4zhheNOlC8XaaHgyUq+NjHHDZF5B4mX7huWfM+kC4u5nCvajoHdfeOse4e1n5RlXtlKRqzBbIma6w8Ej32qFxRLvp4lUXzCylYHBLGH42CKWvtxvETwJUb1kIW9DExSnD+u5fd4Dc2D98\/SY79OO4+aa7GA7JV7412S5kWbtq5cpnkDlvhon\/XzLVQlIqIiAJ6ukVmx root@cscale-82-140"
],
"pod_ns":"t001-u000003",
"hostname":"test-ds-1-server-01.t001-u000003.svc.cluster.local",
"k8s_provider":"robin",
"appid":46,
"vnodehookargs":{
"postcreate":[
]
},
"numa_allocations":{
"0":{
"isol_shared_cores_used":0,
"gpu_used":0,
"hugepages_1g_used":0,
"hugepages_2m_used":0,
"mem_used":209715200,
"non_isol_cores_used":1,
"isol_dedicated_cores_used":0
}
},
"enable_portmapping":true,
"storage":[
{
"pvcpolicy":"create",
"lvm_type":"None",
"size":1073741824,
"stordriver":{
"type":"das",
"faultdomain":"host",
"protection":0,
"media":"HDD"
},
"disk_tags":{
},
"encryption":"none",
"vol_ns":"t001-u000003",
"snapshot_space_limit":214748365,
"fstype":"ext4",
"protection":0,
"workload":0,
"name":"test-ds-1.server.01.data.1.e5506da8-8c25-460d-926b-146ab4b2c9c8",
"blocksize":4096,
"compression":"disabled",
"type":"data",
"media":"HDD",
"faultdomain":"host",
"lvm_vol_count":"0",
"allocated":{
"partitions":0,
"volumeid":"159",
"params":{
},
"media":72,
"size":1073741824,
"stordriver":{
"type":"das",
"faultdomain":"host",
"protection":0,
"media":"HDD"
},
"block_size":4096,
"current_snapshot":"active_snap",
"multinode_mounting":false,
"snapshot_space_limit":214748365,
"slice_size":1073741824,
"protection":0,
"next_backupid":1,
"name":"test-ds-1.server.01.data.1.e5506da8-8c25-460d-926b-146ab4b2c9c8",
"next_snapshotid":2,
"qgroupid":158,
"priority":2,
"genkey":1597453455641718,
"appname":"default",
"grpid":158,
"replication":1,
"vtype":0,
"current_snapshotid":1,
"compression":0,
"appid":1,
"resource_poolid":1
},
"replication":1,
"snap_reserved":20,
"device":"\/dev\/sde",
"path":"\/data",
"layout":"round-robin",
"volgrp_name":"test-ds-1.server.01.72.1.100e29ae-e508-4f21-a253-e3c912fcc242",
"k8s_name":"test-ds-1-server-01-data-1-e5506da8"
},
{
"pvcpolicy":"create",
"lvm_type":"None",
"size":1073741824,
"stordriver":{
"type":"das",
"faultdomain":"host",
"protection":0,
"media":"HDD"
},
"disk_tags":{
},
"encryption":"none",
"vol_ns":"t001-u000003",
"snapshot_space_limit":214748365,
"fstype":"raw",
"protection":0,
"workload":0,
"name":"test-ds-1.server.01.block.1.fa7b93eb-46f5-4830-b664-4428ed4088e9",
"blocksize":4096,
"compression":"disabled",
"type":"block",
"media":"HDD",
"faultdomain":"host",
"lvm_vol_count":"0",
"allocated":{
"partitions":0,
"volumeid":"158",
"params":{
},
"media":72,
"size":1073741824,
"stordriver":{
"type":"das",
"faultdomain":"host",
"protection":0,
"media":"HDD"
},
"block_size":4096,
"current_snapshot":"active_snap",
"multinode_mounting":false,
"snapshot_space_limit":214748365,
"slice_size":1073741824,
"protection":0,
"next_backupid":1,
"name":"test-ds-1.server.01.block.1.fa7b93eb-46f5-4830-b664-4428ed4088e9",
"next_snapshotid":2,
"qgroupid":159,
"priority":2,
"genkey":1597453455638742,
"appname":"default",
"grpid":159,
"replication":1,
"vtype":0,
"current_snapshotid":1,
"compression":0,
"appid":1,
"resource_poolid":1
},
"replication":1,
"snap_reserved":20,
"device":"\/dev\/sdf",
"path":"\/dev\/rda",
"layout":"round-robin",
"volgrp_name":"test-ds-1.server.01.72.1.18e90f5c-d221-4a5b-8fe9-4abc80a84776",
"k8s_name":"test-ds-1-server-01-block-1-fa7b93eb"
}
],
"id":79,
"utime":1597453464,
"host_ip":"172.21.27.101",
"restart_on_qoscfg":true,
"hosttags":{
"kubernetes.io\/os":[
"linux"
],
"robin.io\/robinrpool":[
"default"
],
"kubernetes.io\/arch":[
"amd64"
]
},
"network":[
{
"name":"robin-default",
"allocated_ip":"172.21.27.101",
"allocated_names":[
"eth0"
],
"allocated_by":"system",
"interfaces":1,
"ippool":"robin-default",
"driver":"calico",
"allocated_prefix":16,
"allocated_netmask":"255.255.0.0",
"subnet":"172.21.0.0"
}
],
"bundle_object_id":"64495e524cbc9f133d4b92bcc04e1f94",
"enable_metrics":true,
"bundleid":7,
"appname":"test-ds-1",
"allocated":{
"zonename":"default",
"nodeid":1,
"zoneid":1597147518,
"nodename":"cscale-82-140"
},
"restart_num":15,
"volume_groups":[
{
"volumes":[
"test-ds-1.server.01.data.1.e5506da8-8c25-460d-926b-146ab4b2c9c8"
],
"layout":"round-robin",
"media":"HDD",
"replicas":1,
"rpoolid":1,
"device_sets":[
{
"name":"test-ds-1.server.01.72.1.100e29ae-e508-4f21-a253-e3c912fcc242.0.b93bfd54-808f-4839-abf4-c56143f05737",
"devices":[
{
"max_throughput_intensive_vols_per_disk":1,
"max_latency_sensitive_vols_per_disk":2,
"tags":{
},
"hostname":"cscale-82-140.robinsystems.com",
"score":96,
"allocated_slices":2,
"reattachable":0,
"stormgr_id":2,
"protected":0,
"slices":77,
"max_volumes_per_disk":10,
"aslices":5,
"psize":107374182400,
"write_unit":4096,
"type":"HDD",
"devpath":"\/dev\/disk\/by-id\/scsi-3600224804c48fd7e16c608dea0919064",
"wwn":"0x600224804c48fd7e16c608dea0919064",
"pused":167772160,
"host":"cscale-82-140.robinsystems.com",
"capacity":107374182400,
"state":"READY",
"role":"Storage"
}
],
"stormgr_id":234
}
],
"name":"test-ds-1.server.01.72.1.100e29ae-e508-4f21-a253-e3c912fcc242",
"stormgr_id":158
},
{
"volumes":[
"test-ds-1.server.01.block.1.fa7b93eb-46f5-4830-b664-4428ed4088e9"
],
"layout":"round-robin",
"media":"HDD",
"replicas":1,
"rpoolid":1,
"device_sets":[
{
"name":"test-ds-1.server.01.72.1.18e90f5c-d221-4a5b-8fe9-4abc80a84776.0.2eb1b314-7f19-4cb8-8627-d652544194d9",
"devices":[
{
"max_throughput_intensive_vols_per_disk":1,
"max_latency_sensitive_vols_per_disk":2,
"tags":{
},
"hostname":"cscale-82-140.robinsystems.com",
"score":96,
"allocated_slices":2,
"reattachable":0,
"stormgr_id":2,
"protected":0,
"slices":77,
"max_volumes_per_disk":10,
"aslices":5,
"psize":107374182400,
"write_unit":4096,
"type":"HDD",
"devpath":"\/dev\/disk\/by-id\/scsi-3600224804c48fd7e16c608dea0919064",
"wwn":"0x600224804c48fd7e16c608dea0919064",
"pused":167772160,
"host":"cscale-82-140.robinsystems.com",
"capacity":107374182400,
"state":"READY",
"role":"Storage"
}
],
"stormgr_id":235
}
],
"name":"test-ds-1.server.01.72.1.18e90f5c-d221-4a5b-8fe9-4abc80a84776",
"stormgr_id":159
}
],
"rpoolid":1,
"sidecar_info":{
"mem":0,
"cpu":0,
"containers":[
],
"hugepages_1g":0,
"hugepages_2m":0,
"gpu":0
},
"role":"server",
"vnodehooks":{
"postcreate":"bash postcreate.sh"
},
"engine":"docker",
"desired_status":"ONLINE",
"allocated_host_type":"physical",
"state":"STARTED",
"name":"test-ds-1.server.01",
"enable_hooklogs":true,
"allocated_host_public_hostname":"cscale-82-140.robinsystems.com",
"pod_name":"test-ds-1-server-01",
"jobid":1887,
"cpu":{
"min":0,
"max":1,
"reserve":false
},
"role_name":"server",
"vnodeid":79,
"allocated_host_public_ip":"10.9.82.140",
"bundle_path":"\/usr\/local\/robin\/collections\/file-collection-1597122699552\/1597452431325\/k8s-test-10.0",
"root_fs":"\/usr\/local\/robin\/instances\/test-ds-1-server-01.t001-u000003.svc.cluster.local",
"mem":{
"size":209715200,
"hugepages_1g":0,
"hugepages_2m":0
},
"image":{
"name":"robinsys\/centos",
"engine":"docker",
"registry_hostname":"",
"version":"7",
"registry_port":"",
"entrypoint":"entry.sh",
"init_mode":false
},
"env":{
"DOCKER_OPTS":{
"value":"-v \/sys\/fs\/cgroup:\/sys\/fs\/cgroup --cap-add=SYS_ADMIN",
"type":"text"
},
"ROOT_PASSWORD":{
"value":"",
"type":"password"
},
"allocated":{
"ROBINHOST":"cscale-82-140.robinsystems.com",
"DOCKER_OPTS":"-v \/sys\/fs\/cgroup:\/sys\/fs\/cgroup --cap-add=SYS_ADMIN",
"ROBINHOST_TAG_KUBERNETES.IO-ARCH":"amd64",
"ENABLE_SSH":true,
"ROBINHOST_TAG_KUBERNETES.IO-OS":"linux",
"ROBINHOST_TAG_ROBINRPOOL":"default",
"POD_NAME":"test-ds-1-server-01",
"POD_NS":"t001-u000003",
"ROOT_PASSWORD":"",
"K8S_NODE":"cscale-82-140"
},
"ENABLE_SSH":{
"value":true,
"type":"boolean"
}
},
"ctime":1597453464,
"service_uids":[
],
"calico_inuse":true,
"gpu":{
"min":0,
"max":0
}
}
],
"image":{
"name":"robinsys\/centos",
"engine":"docker",
"registry_hostname":"",
"version":"7",
"registry_port":"",
"entrypoint":"entry.sh",
"init_mode":false
},
"display_name":"server",
"qgroups":{
"data":{
"wr_weight":1,
"wr_min_window":500,
"rd_min_window":500,
"enabled":false,
"rd_max_iops":2000000,
"wr_min_iops":0,
"wr_max_iops":2000000,
"priority":1,
"rd_weight":1,
"rd_min_iops":0
},
"block":{
"wr_weight":1,
"wr_min_window":500,
"rd_min_window":500,
"enabled":false,
"rd_max_iops":2000000,
"wr_min_iops":0,
"wr_max_iops":2000000,
"priority":1,
"rd_weight":1,
"rd_min_iops":0
}
},
"restart_on_qoscfg":true
}
],
"from_template":null,
"bundle_object_id":"64495e524cbc9f133d4b92bcc04e1f94",
"apphooks":{
"postdestroy":"python3 postdestroy.py",
"allocated":{
"postdestroy":"python3 postdestroy.py",
"postcreate":"python3 postcreate.py",
"precreate":"python3 precreate.py"
},
"postcreate":"python3 postcreate.py",
"precreate":"python3 precreate.py"
},
"bundleid":7,
"snapshot":"enabled",
"id":46,
"bundle_path":"\/usr\/local\/robin\/collections\/file-collection-1597122699552\/1597452431325\/k8s-test-10.0",
"robin_version":"5.3.1-182",
"restart_num":15,
"clone":"enabled",
"version":"7",
"namespace":"t001-u000003",
"rpool":"default",
"rpoolid":1,
"username":"robin",
"tenant":"Administrators",
"app_ns":"t001-u000003"
},
"jobid":1891
}
10.10. List all Applications¶
The following command will list all applications created or registered with Robin Platform:
# robin app list --app-kind <app_kind>
--app-types <app_type_list>
|
Filter by application kind (valid choices are ‘robin’, ‘helm’, and ‘flexapp’) |
|
Filter by application type (valid choices are’MASTER’ and ‘CLONE’) |
Example 1 (Listing all Applications):
# robin app list
ROBIN Bundle Apps:
+-------+--------------+--------+--------+---------------+--------+-----+-----+-------------+--------+---------+-----------+-------+
| Name | Owner/Tenant | Type | Parent | Resource Pool | Vnodes | CPU | GPU | Memory (GB) | Status | LastOpr | Health | Error |
+-------+--------------+--------+--------+---------------+--------+-----+-----+-------------+--------+---------+-----------+-------+
| mysql | admin1/t1 | MASTER | - | default | 1 | 4 | 0 | 4 | Ready | ONLINE | Unhealthy | 0 |
| pgsql | admin1/t1 | MASTER | - | default | 1 | 1 | 0 | 1 | Ready | ONLINE | Unknown | 0 |
+-------+--------------+--------+--------+---------------+--------+-----+-----+-------------+--------+---------+-----------+-------+
Helm/Flex Apps:
+-----------+---------+-------------+--------------+--------------+-----------+---------+
| Name | Type | State | Owner/Tenant | Namespace | Snapshots | Backups |
+-----------+---------+-------------+--------------+--------------+-----------+---------+
| mysql1 | helm | ONLINE | admin1/t1 | t003-u000004 | 1 | 1 |
| mysql-hb1 | helm | ONLINE | admin1/t1 | t003-u000004 | 0 | 0 |
| mysql2 | helm | ONLINE | admin1/t1 | t003-u000004 | 0 | 0 |
| mysql1-b1 | flexapp | INITIALIZED | admin1/t1 | t003-u000004 | 0 | 0 |
+-----------+---------+-------------+--------------+--------------+-----------+---------+
Example 2 (Listing only Robin Applications):
# robin app list --app-kind robin
ROBIN Bundle Apps:
+-------+--------------+--------+--------+---------------+--------+-----+-----+-------------+--------+---------+-----------+-------+
| Name | Owner/Tenant | Type | Parent | Resource Pool | Vnodes | CPU | GPU | Memory (GB) | Status | LastOpr | Health | Error |
+-------+--------------+--------+--------+---------------+--------+-----+-----+-------------+--------+---------+-----------+-------+
| mysql | admin1/t1 | MASTER | - | default | 1 | 4 | 0 | 4 | Ready | ONLINE | Unhealthy | 0 |
| pgsql | admin1/t1 | MASTER | - | default | 1 | 1 | 0 | 1 | Ready | ONLINE | Unknown | 0 |
+-------+--------------+--------+--------+---------------+--------+-----+-----+-------------+--------+---------+-----------+-------+
Returns information on all applications within a cluster including details on their statuses (from Robin’s perspective), resource consumption, and their owners.
End Point: /api/v6/robin_server/appsview
Method: GET
URL Parameters:
atype=[MASTER,CLONE]: Utilizing this parameter filters the results by the type specified. Valid values include MASTER and CLONE.akind=[robin,helm,flexapp]: Utilizing this parameter filters the results by the kind specified. Valid values include robin, helm and flexapp.
Data Parameters: None
Port: RCM Port (default value is 29442)
Headers:
Authorization: <auth_token>: Authorization token to identify which user is sending the request. The token can be acquired from the login API.
Success Response Code: 200
Error Response Code: 500 (Internal Server Error)
Example Response:
Output
{
"robin":{
"tenants":[
{
"name":"Administrators",
"id":1
}
],
"rpools":[
{
"name":"default",
"id":1
}
],
"zones":[
{
"zoneid":1597969746,
"name":"default",
"id":1
}
],
"vnodes":[
{
"nodeid":1,
"mem":4194304,
"userid":3,
"zoneid":null,
"cpu":1,
"role":"dsbundle",
"gpu":0,
"hugepages_1g":0,
"utime":1598343982,
"hugepages_2m":0,
"hostname":"test-app-new-dsbundle-01.t001-u000003.svc.cluster.local",
"name":"test-app-new.dsbundle.01",
"status":"ONLINE",
"pod_name":"test-app-new-dsbundle-01",
"appid":12,
"engine":"docker",
"tenantid":1,
"state":"STARTED",
"id":12,
"desired_status":"ONLINE",
"pod_ns":"t001-u000003"
},
{
"nodeid":1,
"mem":1283457024,
"userid":3,
"zoneid":null,
"cpu":1,
"role":"nginx",
"gpu":0,
"hugepages_1g":0,
"utime":1598453564,
"hugepages_2m":0,
"hostname":"demo-nginx-01.t001-u000003.svc.cluster.local",
"name":"demo.nginx.01",
"status":"ONLINE",
"pod_name":"demo-nginx-01",
"appid":13,
"engine":"docker",
"tenantid":1,
"state":"STARTED",
"id":13,
"desired_status":"ONLINE",
"pod_ns":"t001-u000003"
}
],
"users":[
{
"email":null,
"tenantid":1,
"firstname":"Robin",
"id":3,
"username":"robin",
"lastname":"Systems"
}
],
"nodes":[
{
"rpoolid":1,
"memory_used":0,
"nvnodes":0,
"k8s_node_name":"cscale-82-140",
"zoneid":1,
"cpu":40,
"mem":33555701760,
"mem_for_storage":1073741824,
"cpu_prov_factor":10,
"name":"cscale-82-140.robinsystems.com",
"cpu_cores_present":40,
"state":"ONLINE",
"id":1,
"cores_used":0,
"services":"{\"update_time\":1598470070.8638851643,\"services\":{\"stormgr-server\":{\"ActiveState\":\"active\",\"Type\":\"simple\",\"ExecMainStartTimestamp\":\"2020-08-20 10:29:43.555551\",\"MainPID\":2275,\"Id\":\"stormgr-server\"},\"consul-server\":{\"ActiveState\":\"active\",\"Type\":\"simple\",\"ExecMainStartTimestamp\":\"2020-08-20 10:28:49.778591\",\"MainPID\":566,\"Id\":\"consul-server\"},\"consul_members\":[{\"Port\":29460,\"Status\":1,\"DelegateMax\":5,\"ProtocolMin\":1,\"Tags\":{\"segment\":\"\",\"bootstrap\":\"1\",\"vsn_min\":\"2\",\"build\":\"0.9.4:40f243a+\",\"vsn_max\":\"3\",\"vsn\":\"2\",\"raft_vsn\":\"2\",\"role\":\"consul\",\"dc\":\"consul\",\"id\":\"9d550700-9fac-4de6-b6bc-1b957e82bda9\",\"wan_join_port\":\"29461\",\"port\":\"29459\"},\"Name\":\"cscale-82-140.robinsystems.com\",\"DelegateMin\":2,\"ProtocolCur\":2,\"DelegateCur\":4,\"Addr\":\"10.9.82.140\",\"ProtocolMax\":5}],\"robin-auth-server\":{\"ActiveState\":\"active\",\"Type\":\"simple\",\"ExecMainStartTimestamp\":\"2020-08-20 10:29:10.587576\",\"MainPID\":1007,\"Id\":\"robin-auth-server\"},\"robin-node-monitor\":{\"ActiveState\":\"active\",\"Type\":\"simple\",\"ExecMainStartTimestamp\":\"2020-08-20 10:29:31.387560\",\"MainPID\":1245,\"Id\":\"robin-node-monitor\"},\"robin-watchdog\":{\"ActiveState\":\"active\",\"Type\":\"simple\",\"ExecMainStartTimestamp\":\"2020-08-20 10:28:54.388588\",\"MainPID\":867,\"Id\":\"robin-watchdog\"},\"sherlock-server\":{\"ActiveState\":\"inactive\",\"Type\":\"simple\",\"ExecMainStartTimestamp\":0,\"MainPID\":0,\"Id\":\"sherlock-server\"},\"httpd\":{\"ActiveState\":\"active\",\"Type\":\"simple\",\"ExecMainStartTimestamp\":\"2020-08-20 10:29:46.799549\",\"MainPID\":2590,\"Id\":\"httpd\"},\"robin-file-server\":{\"ActiveState\":\"active\",\"Type\":\"simple\",\"ExecMainStartTimestamp\":\"2020-08-20 10:29:15.559572\",\"MainPID\":1074,\"Id\":\"robin-file-server\"},\"robin-event-server\":{\"ActiveState\":\"active\",\"Type\":\"simple\",\"ExecMainStartTimestamp\":\"2020-08-20 10:29:15.088572\",\"MainPID\":1041,\"Id\":\"robin-event-server\"},\"consul-client\":{\"ActiveState\":\"inactive\",\"Type\":\"simple\",\"ExecMainStartTimestamp\":0,\"MainPID\":0,\"Id\":\"consul-client\"},\"gui-cli\":{\"ActiveState\":\"active\",\"Type\":\"simple\",\"ExecMainStartTimestamp\":\"2020-08-20 10:29:46.964548\",\"MainPID\":2622,\"Id\":\"gui-cli\"},\"robin-agent\":{\"ActiveState\":\"active\",\"Type\":\"simple\",\"ExecMainStartTimestamp\":\"2020-08-20 10:29:38.987554\",\"MainPID\":1716,\"Id\":\"robin-agent\"},\"robin-server\":{\"ActiveState\":\"active\",\"Type\":\"simple\",\"ExecMainStartTimestamp\":\"2020-08-26 12:27:39.201277\",\"MainPID\":15116,\"Id\":\"robin-server\"},\"iomgr-server\":{\"ActiveState\":\"active\",\"Type\":\"simple\",\"ExecMainStartTimestamp\":\"2020-08-20 12:51:14.290049\",\"MainPID\":29172,\"Id\":\"iomgr-server\"},\"monitor-server\":{\"ActiveState\":\"active\",\"Type\":\"simple\",\"ExecMainStartTimestamp\":\"2020-08-20 10:29:47.114548\",\"MainPID\":2662,\"Id\":\"monitor-server\"},\"postgresql-9.6\":{\"ActiveState\":\"active\",\"Type\":\"simple\",\"ExecMainStartTimestamp\":\"2020-08-20 10:28:52.396589\",\"MainPID\":662,\"Id\":\"postgresql-9.6\"},\"consul_dns\":true}}"
}
],
"bundles":[
{
"version":"1.0",
"name":"nginx",
"share_with_all_tenants":false,
"tenantid":1,
"userid":3,
"zoneid":1,
"limitperbundle":0,
"id":1
},
{
"version":"1.0",
"name":"tolerations",
"share_with_all_tenants":false,
"tenantid":1,
"userid":3,
"zoneid":1,
"limitperbundle":0,
"id":2
},
{
"version":"1.0",
"name":"dsbundle",
"share_with_all_tenants":false,
"tenantid":1,
"userid":3,
"zoneid":1,
"limitperbundle":0,
"id":3
},
{
"version":"2.0",
"name":"dsbundle",
"share_with_all_tenants":false,
"tenantid":1,
"userid":3,
"zoneid":1,
"limitperbundle":0,
"id":4
},
{
"version":"3.0",
"name":"dsbundle",
"share_with_all_tenants":false,
"tenantid":1,
"userid":3,
"zoneid":1,
"limitperbundle":0,
"id":5
},
{
"version":"4.0",
"name":"dsbundle",
"share_with_all_tenants":false,
"tenantid":1,
"userid":3,
"zoneid":1,
"limitperbundle":0,
"id":6
},
{
"version":"10.0",
"name":"dsbundle",
"share_with_all_tenants":false,
"tenantid":1,
"userid":3,
"zoneid":1,
"limitperbundle":0,
"id":7
},
{
"version":"11.0",
"name":"dsbundle",
"share_with_all_tenants":false,
"tenantid":1,
"userid":3,
"zoneid":1,
"limitperbundle":0,
"id":8
},
{
"version":"12.0",
"name":"dsbundle",
"share_with_all_tenants":false,
"tenantid":1,
"userid":3,
"zoneid":1,
"limitperbundle":0,
"id":9
},
{
"version":"15.0",
"name":"dsbundle",
"share_with_all_tenants":false,
"tenantid":1,
"userid":3,
"zoneid":1,
"limitperbundle":0,
"id":10
},
{
"version":"new",
"name":"dsbundle",
"share_with_all_tenants":false,
"tenantid":1,
"userid":3,
"zoneid":1,
"limitperbundle":0,
"id":11
},
{
"version":"20.0",
"name":"dsbundle",
"share_with_all_tenants":false,
"tenantid":1,
"userid":3,
"zoneid":1,
"limitperbundle":0,
"id":12
}
],
"apps":[
{
"rpoolid":1,
"nvnodes":1,
"zoneid":1,
"mem":4194304,
"atype":"MASTER",
"name":"test-app-new",
"status":"Ready",
"hugepages_1g":0,
"tenantid":1,
"error":0,
"utime":1598343982,
"parentid":null,
"userid":3,
"cpu":1,
"gpu":0,
"bundleid":12,
"hugepages_2m":0,
"health":"Unknown",
"ctime":1598343982,
"unique_id":"a54ef254e6ac11eaa97cc972afea67da",
"state":"ONLINE",
"id":12,
"parent_app":""
},
{
"rpoolid":1,
"nvnodes":1,
"zoneid":1,
"mem":1283457024,
"atype":"MASTER",
"name":"demo",
"status":"Ready",
"hugepages_1g":0,
"tenantid":1,
"error":0,
"utime":1598453574,
"parentid":null,
"userid":3,
"cpu":1,
"gpu":0,
"bundleid":1,
"hugepages_2m":0,
"health":"Unknown",
"ctime":1598453564,
"unique_id":"ba9df9e8e7ab11eaa8012d67016161bd",
"state":"ONLINE",
"id":13,
"parent_app":""
}
]
},
"k8s":[
{
"backup_schedule":{
},
"id":"da5f043ae7d211ea8ed2b5f75df49f21",
"query":"{\"namespace\":\"t001-u000003\",\"resources\":[],\"selectors\":[],\"apps\":[\"helm\\\/ideal-giraffe\"]}",
"kind":"helm",
"tenant":"Administrators",
"snapshot_schedule":{
},
"namespace":"t001-u000003",
"name":"demo-helm",
"state":"ONLINE",
"num_snapshots":0,
"username":"robin",
"num_backups":0
}
]
}
10.11. Show information about a specific Application¶
Issue the following command to get detailed information about a specific application instance:
# robin app info <appname>
--services
--network
|
Application instance name |
|
Display information about services for an application |
|
Display network information for an application |
Example 1 (Showing information about a Robin app):
# robin app info mysql
Name: mysql
Bundle Info: mysql docker-8.0
Autopilot: Enabled
ROLE mysql (vnodes: 1)
HPA: Not Configured
VNODE 1:mysql.mysql.01 : mysql-mysql-01 (4 cores) (0 GPUs) (4G) (Hugepages-2m: -) (Hugepages-1g: -) (SSD: -) (HDD: 12G) (SVC ports: -) ONLINE
Volume | MntPoint | Size (GB) | SnapSize (GB) | Layout | Media
-----------------------------------------------------------+----------------+-----------+---------------+-------------+-------
mysql.mysql.01.data.1.da86f291-f60a-4d82-82ea-d6e5f7e4e9d1 | /var/lib/mysql | 10 | 2 | round-robin | HDD
App Hooks: Enabled
Vnode Hooks: Enabled
Example 2 (Showing information about a HELM app):
# robin app info mysql1
Backups:
Name : mysql1
Kind : helm
State : ONLINE
Number of repos : 1
Number of snapshots : 1
Number of usable backups : 0
Number of archived/failed backups : 1
Query:
-------
{'apps': ['helm/trendy-crocodile'], 'namespace': 't003-u000004', 'resources': [], 'selectors': []}
Repos:
+----------+-----------------------+----------+------------+
| Name | Bucket | Path | Permission |
+----------+-----------------------+----------+------------+
| testrepo | testbucket-1029384756 | dev/tom/ | readwrite |
+----------+-----------------------+----------+------------+
Snapshots:
+----------------------------------+----------------------------+-------------+--------+----------------------+
| Id | Name | Description | State | Creation Time |
+----------------------------------+----------------------------+-------------+--------+----------------------+
| 327ab8b447b111eaae7f0f55d6e44d6c | mysql1_snapshot-1580863693 | - | ONLINE | 04 Feb 2020 16:48:19 |
+----------------------------------+----------------------------+-------------+--------+----------------------+
Archived/Failed Backups:
+----------------------------------+--------------------------+-------------+-----------------+----------------------+
| Id | Name | Description | State | Creation Time |
+----------------------------------+--------------------------+-------------+-----------------+----------------------+
| 36b7c9de47b111eaaf8deb154706dccd | mysql1_backup-1580863693 | - | Deleted locally | 04 Feb 2020 16:48:24 |
+----------------------------------+--------------------------+-------------+-----------------+----------------------+
Example 3 (Showing information about all K8S services for an application):
# robin app info nginx-app --services
App Name: nginx-app
Services:
+-------------------------+--------------+-----------+---------------+----------------+-------------+
| Service Name | Type | Ports | Service Level | Cluster IP | External IP |
+-------------------------+--------------+-----------+---------------+----------------+-------------+
| nginx-app-nginx-cl-0 | ClusterIP | 80 | Role | 172.19.88.109 | N/A |
| nginx-app-nginx-lb-0 | LoadBalancer | 80:32742 | Role | 172.19.149.207 | None |
| nginx-app-nginx-01-np-0 | NodePort | 80:30486 | VNode | 172.19.219.189 | N/A |
+-------------------------+--------------+-----------+---------------+----------------+-------------+
Example 4 (Showing network information for an application):
# robin app info nginx-app --network
App Name: nginx-app
Network Info:
+--------------------+--------------+-----------------+
| Vnode | IP Addrs | Number of Intfs |
+--------------------+--------------+-----------------+
| nginx-app.nginx.01 | 172.21.27.0 | 1 |
+--------------------+--------------+-----------------+
Returns detailed information about an application, such as the volumes serving as storage, the resource breakdown and status of each container for every role.
End Point: /api/v6/robin_server/apps/<appname>?info=true&details=vnodes
Method: GET
URL Parameters: None
Data Parameters: None
Port: RCM Port (default value is 29442)
Headers:
Authorization: <auth_token>: Authorization token to identify which user is sending the request. The token can be acquired from the login API.
Success Response Code: 200
Error Response Code: 500 (Internal Server Error), 404 (Not Found Error), 401 (Unauthorized Error)
Example Response:
Output
{
"error":0,
"updates_available":false,
"disk":2147483648,
"zoneid":1596601846,
"bundle_version":"1.5",
"bundle_name":"RIC",
"ctime":1596663233,
"owner":{
"last_name":"Systems",
"tenant_id":1,
"username":"robin",
"first_name":"Robin",
"tenant_name":"Administrators",
"email":null,
"user_id":3
},
"ainstances":[
{
"id":6,
"role":"server",
"memory":209715200,
"events":[
],
"vnc_port":null,
"utime":1596663233,
"user":"robin",
"state":"STARTED",
"name":"test-RIC-1.server.01",
"ctime":1596663233,
"public_ips":[
],
"image_format":"UNKNOWN",
"hugepages_2m":0,
"storage":[
{
"size":1073741824,
"media":"HDD",
"state":"ONLINE",
"name":"test-RIC-1.server.01.data.1.382f1ad5-1294-4e24-8297-9c6025eacfe5",
"id":"8"
},
{
"size":1073741824,
"media":"HDD",
"state":"ONLINE",
"name":"test-RIC-1.server.01.block.1.1053eaeb-4542-42a5-a173-d69a76703ead",
"id":"9"
}
],
"bundle":{
"pathname":"\/usr\/local\/robin\/collections\/file-collection-1596578146092\/1596663217668\/RIC-1.5",
"description":"-",
"tenants":[
"Administrators"
],
"create_time":"August 05, 2020 14:33:37",
"content_id":"f972a5725d1bfe2671a79d61856f872a",
"zoneid":1596601846,
"share_with_all_tenants":false,
"user":"robin",
"type":"ROBIN",
"name":"RIC",
"nchildren":0,
"version":"1.5",
"file_object_id":1596663217668,
"bundleid":3,
"ntemplates":1,
"tenant":"Administrators",
"collection_id":1596578146092,
"napps":1,
"parent":"",
"groupid":3
},
"image":{
"version":"",
"file":"",
"name":""
},
"network_bandwidth":null,
"app":"test-RIC-1",
"status":"ONLINE",
"cpu_cores":1,
"config":{
"restart_num":15,
"service_uids":[
],
"appname":"test-RIC-1",
"allocated_host":"cscale-82-140.robinsystems.com",
"allocated_host_public_ip":"10.9.82.140",
"cpu":{
"max":1,
"min":0,
"reserve":false
},
"sidecar_info":{
"hugepages_1g":0,
"mem":0,
"hugepages_2m":0,
"containers":[
],
"cpu":0,
"gpu":0
},
"id":6,
"role_name":"server",
"hosttags":{
"kubernetes.io\/os":[
"linux"
],
"robin.io\/robinrpool":[
"default"
],
"kubernetes.io\/arch":[
"amd64"
]
},
"pod_name":"test-ric-1-server-01",
"role":"server",
"rpoolid":1,
"network":[
{
"subnet":"172.21.0.0",
"allocated_by":"system",
"allocated_ip":"172.21.26.94",
"allocated_prefix":16,
"allocated_names":[
"eth0"
],
"interfaces":1,
"driver":"calico",
"allocated_netmask":"255.255.0.0",
"ippool":"robin-default",
"name":"robin-default"
}
],
"storage":[
{
"volgrp_name":"test-RIC-1.server.01.72.1.ea297971-f931-4787-99cc-6782e026b77c",
"media":"HDD",
"stordriver":{
"media":"HDD",
"protection":0,
"faultdomain":"host",
"type":"das"
},
"workload":0,
"type":"data",
"snapshot_space_limit":214748365,
"faultdomain":"host",
"name":"test-RIC-1.server.01.data.1.382f1ad5-1294-4e24-8297-9c6025eacfe5",
"blocksize":4096,
"layout":"round-robin",
"disk_tags":{
},
"allocated":{
"media":72,
"volumeid":"8",
"priority":2,
"genkey":1596663220770472,
"grpid":8,
"partitions":0,
"snapshot_space_limit":214748365,
"name":"test-RIC-1.server.01.data.1.382f1ad5-1294-4e24-8297-9c6025eacfe5",
"current_snapshot":"active_snap",
"params":{
},
"stordriver":{
"media":"HDD",
"protection":0,
"faultdomain":"host",
"type":"das"
},
"next_backupid":1,
"appname":"default",
"vtype":0,
"resource_poolid":1,
"current_snapshotid":1,
"block_size":4096,
"size":1073741824,
"replication":1,
"multinode_mounting":false,
"appid":1,
"next_snapshotid":2,
"protection":0,
"compression":0,
"slice_size":1073741824,
"qgroupid":8
},
"pvcpolicy":"create",
"fstype":"ext4",
"snap_reserved":20,
"size":1073741824,
"lvm_vol_count":"0",
"lvm_type":"None",
"encryption":"none",
"protection":0,
"compression":"disabled",
"vol_ns":"t001-u000003",
"replication":1,
"path":"\/data",
"k8s_name":"test-ric-1-server-01-data-1-382f1ad5"
},
{
"volgrp_name":"test-RIC-1.server.01.72.1.1e483fd0-2d5c-434c-aef0-91a87796977a",
"media":"HDD",
"stordriver":{
"media":"HDD",
"protection":0,
"faultdomain":"host",
"type":"das"
},
"workload":0,
"type":"block",
"snapshot_space_limit":214748365,
"faultdomain":"host",
"name":"test-RIC-1.server.01.block.1.1053eaeb-4542-42a5-a173-d69a76703ead",
"blocksize":4096,
"layout":"round-robin",
"disk_tags":{
},
"allocated":{
"media":72,
"volumeid":"9",
"priority":2,
"genkey":1596663220787432,
"grpid":9,
"partitions":0,
"snapshot_space_limit":214748365,
"name":"test-RIC-1.server.01.block.1.1053eaeb-4542-42a5-a173-d69a76703ead",
"current_snapshot":"active_snap",
"params":{
},
"stordriver":{
"media":"HDD",
"protection":0,
"faultdomain":"host",
"type":"das"
},
"next_backupid":1,
"appname":"default",
"vtype":0,
"resource_poolid":1,
"current_snapshotid":1,
"block_size":4096,
"size":1073741824,
"replication":1,
"multinode_mounting":false,
"appid":1,
"next_snapshotid":2,
"protection":0,
"compression":0,
"slice_size":1073741824,
"qgroupid":9
},
"pvcpolicy":"create",
"fstype":"raw",
"snap_reserved":20,
"size":1073741824,
"replication":1,
"lvm_type":"None",
"encryption":"none",
"protection":0,
"compression":"disabled",
"vol_ns":"t001-u000003",
"lvm_vol_count":"0",
"path":"\/dev\/rda",
"k8s_name":"test-ric-1-server-01-block-1-1053eaeb"
}
],
"cm_keys":[
"ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDgHRR3k5onnh+hjqpoW\/oLkr37GOs2f8FQVDJUHHrDeB+\/cn9c\/nez4lu9J0FkCe+mQwhnuiCicunZEjVZOWpIvjxblbw6Lh7ZkN+o5mOkcxCayrp3fDFnR1PerJJhRPnJU60zxFYbAGPrQtCywQ+b7J9hLtNaqCBf9eAwVWiLSEcFs0SkrjXjFjXOTCaq8b45AWSYc6ZxhzMsFTkTF3C37rTmEGIijmDvUbq1HRGXtQ2YZrlo\/yjJqn8wk8E+cw+Sh\/PEsudaVzoZRqyQ\/lsWBt\/+0nFON8pYttyXPZjKhuGDB5QNtUZ4kgvzDfr1TF1XEXHfo2PdsswRkQ4rU8bF root@cscale-82-140"
],
"env":{
"ENABLE_SSH":{
"value":true,
"type":"boolean"
},
"ROOT_PASSWORD":{
"value":"",
"type":"password"
},
"allocated":{
"K8S_NODE":"cscale-82-140",
"ROBINHOST":"cscale-82-140.robinsystems.com",
"POD_NAME":"test-ric-1-server-01",
"ROOT_PASSWORD":"",
"ENABLE_SSH":true,
"ROBINHOST_TAG_ROBINRPOOL":"default",
"ROBINHOST_TAG_KUBERNETES.IO-ARCH":"amd64",
"ROBINHOST_TAG_KUBERNETES.IO-OS":"linux",
"POD_NS":"t001-u000003",
"DOCKER_OPTS":"-v \/sys\/fs\/cgroup:\/sys\/fs\/cgroup --cap-add=SYS_ADMIN"
},
"DOCKER_OPTS":{
"value":"-v \/sys\/fs\/cgroup:\/sys\/fs\/cgroup --cap-add=SYS_ADMIN",
"type":"text"
}
},
"appid":6,
"root_fs":"\/usr\/local\/robin\/instances\/test-ric-1-server-01.t001-u000003.svc.cluster.local",
"enable_hooklogs":true,
"bundle_object_id":"f972a5725d1bfe2671a79d61856f872a",
"numa_allocations":{
"0":{
"hugepages_1g_used":0,
"hugepages_2m_used":0,
"gpu_used":0,
"isol_shared_cores_used":0,
"non_isol_cores_used":1,
"mem_used":209715200,
"isol_dedicated_cores_used":0
}
},
"utime":1596663233,
"volume_groups":[
{
"layout":"round-robin",
"volumes":[
"test-RIC-1.server.01.data.1.382f1ad5-1294-4e24-8297-9c6025eacfe5"
],
"media":"HDD",
"device_sets":[
{
"devices":[
{
"tags":{
},
"pused":1107296256,
"allocated_slices":2,
"type":"HDD",
"state":"READY",
"aslices":29,
"slices":77,
"stormgr_id":1,
"max_throughput_intensive_vols_per_disk":1,
"write_unit":4096,
"host":"cscale-82-140.robinsystems.com",
"role":"Storage",
"protected":0,
"devpath":"\/dev\/disk\/by-id\/scsi-3600224804c48fd7e16c608dea0919064",
"reattachable":0,
"score":84,
"psize":107374182400,
"max_volumes_per_disk":10,
"wwn":"0x600224804c48fd7e16c608dea0919064",
"capacity":107374182400,
"hostname":"cscale-82-140.robinsystems.com",
"max_latency_sensitive_vols_per_disk":2
}
],
"name":"test-RIC-1.server.01.72.1.ea297971-f931-4787-99cc-6782e026b77c.0.1e8feb41-fd42-4409-b8c1-751331febdc1",
"stormgr_id":8
}
],
"rpoolid":1,
"name":"test-RIC-1.server.01.72.1.ea297971-f931-4787-99cc-6782e026b77c",
"replicas":1,
"stormgr_id":8
},
{
"layout":"round-robin",
"volumes":[
"test-RIC-1.server.01.block.1.1053eaeb-4542-42a5-a173-d69a76703ead"
],
"media":"HDD",
"device_sets":[
{
"devices":[
{
"tags":{
},
"pused":1107296256,
"allocated_slices":2,
"type":"HDD",
"state":"READY",
"aslices":29,
"slices":77,
"stormgr_id":1,
"max_throughput_intensive_vols_per_disk":1,
"write_unit":4096,
"host":"cscale-82-140.robinsystems.com",
"role":"Storage",
"protected":0,
"devpath":"\/dev\/disk\/by-id\/scsi-3600224804c48fd7e16c608dea0919064",
"reattachable":0,
"score":84,
"psize":107374182400,
"max_volumes_per_disk":10,
"wwn":"0x600224804c48fd7e16c608dea0919064",
"capacity":107374182400,
"hostname":"cscale-82-140.robinsystems.com",
"max_latency_sensitive_vols_per_disk":2
}
],
"name":"test-RIC-1.server.01.72.1.1e483fd0-2d5c-434c-aef0-91a87796977a.0.5bf728c4-ea26-4e0f-82d7-c584fcf0bd9a",
"stormgr_id":9
}
],
"rpoolid":1,
"name":"test-RIC-1.server.01.72.1.1e483fd0-2d5c-434c-aef0-91a87796977a",
"replicas":1,
"stormgr_id":9
}
],
"bundleid":3,
"vnodehooks":{
"postcreate":"bash postcreate.sh"
},
"mem":{
"size":209715200,
"hugepages_1g":0,
"hugepages_2m":0
},
"enable_portmapping":true,
"state":"STARTED",
"name":"test-RIC-1.server.01",
"k8s_provider":"robin",
"ctime":1596663233,
"vnodeid":6,
"allocated":{
"zoneid":1596601846,
"nodename":"cscale-82-140",
"nodeid":1,
"zonename":"default"
},
"image":{
"init_mode":false,
"version":"7",
"registry_hostname":"",
"entrypoint":"entry.sh",
"name":"robinsys\/centos",
"engine":"docker",
"registry_port":""
},
"calico_inuse":true,
"enable_metrics":true,
"bundle_path":"\/usr\/local\/robin\/collections\/file-collection-1596578146092\/1596663217668\/RIC-1.5",
"vnodehookargs":{
"postcreate":[
]
},
"pod_ns":"t001-u000003",
"allocated_host_public_hostname":"cscale-82-140.robinsystems.com",
"allocated_host_type":"physical",
"hostname":"test-ric-1-server-01.t001-u000003.svc.cluster.local",
"host_ip":"172.21.26.94",
"restart_on_qoscfg":true,
"engine":"docker",
"gpu":{
"max":0,
"min":0
}
},
"physical_host":{
"compute_status":"READY",
"status":1,
"hostname":"cscale-82-140.robinsystems.com",
"compute_state":"ONLINE",
"public_hostname":"cscale-82-140.robinsystems.com",
"compute_services":[
[
"robin-agent",
true
],
[
"monitor-server",
true
],
[
"iomgr-server",
true
]
],
"state":"ONLINE",
"public_ip":"10.9.82.140"
},
"gpu_cores":0,
"restartpolicy":{
"restarts_done":0,
"burst_count":0,
"burst_start_time":0,
"burst_interval":600,
"id":13,
"restart_limit":15
},
"distribution":{
"version":"",
"name":""
},
"root_fs":"\/usr\/local\/robin\/instances\/test-ric-1-server-01.t001-u000003.svc.cluster.local",
"volumes":[
{
"size":1073741824,
"media":"HDD",
"state":"ONLINE",
"name":"test-RIC-1.server.01.data.1.382f1ad5-1294-4e24-8297-9c6025eacfe5",
"id":"8"
},
{
"size":1073741824,
"media":"HDD",
"state":"ONLINE",
"name":"test-RIC-1.server.01.block.1.1053eaeb-4542-42a5-a173-d69a76703ead",
"id":"9"
}
],
"capacity":{
"threshold":85,
"used":0,
"total":0,
"unit":"Bytes"
},
"service_ports":null,
"tenant":"Administrators",
"hugepages_1g":0,
"rpool":"default",
"autopilot":true,
"desired_status":"ONLINE",
"ip_addresses":[
"172.21.26.94\/16"
],
"engine":"docker",
"hostname":"test-ric-1-server-01.t001-u000003.svc.cluster.local"
}
],
"local_avail":true,
"nbackups":0,
"id":6,
"clone":false,
"unique_id":"549c0ac2d76311eab3c057add9d364f3",
"parentid":"",
"status":"Ready",
"atype":"MASTER",
"message":"",
"nsnapshots":0,
"utime":1596663233,
"rpool":"default",
"autopilot":true,
"snapshots":[
],
"user_shares":[
],
"mem":209715200,
"backups":[
],
"state":"ONLINE",
"name":"test-RIC-1",
"cpu":1,
"restore_status":{
},
"appinfo":{
},
"nvnodes":1,
"resources":[
],
"health":"Unknown",
"config":{
"content_id":"f972a5725d1bfe2671a79d61856f872a",
"from_template":null,
"enable_metrics":true,
"kind":"ROBIN",
"id":6,
"name":"test-RIC-1",
"auto_relocate":true,
"version":"7",
"zoneid":1596601846,
"app_ns":"t001-u000003",
"namespace":"t001-u000003",
"tenant":"Administrators",
"clone":"enabled",
"pvcpolicy":"create",
"planid":6,
"restart_num":15,
"rpoolid":1,
"roles":[
{
"qgroups":{
"block":{
"rd_weight":1,
"rd_max_iops":2000000,
"priority":1,
"wr_min_iops":0,
"wr_min_window":500,
"rd_min_iops":0,
"rd_min_window":500,
"enabled":false,
"wr_max_iops":2000000,
"wr_weight":1
},
"data":{
"rd_weight":1,
"rd_max_iops":2000000,
"priority":1,
"wr_min_iops":0,
"wr_min_window":500,
"rd_min_iops":0,
"rd_min_window":500,
"enabled":false,
"wr_max_iops":2000000,
"wr_weight":1
}
},
"vnodes":[
{
"restart_num":15,
"service_uids":[
],
"appname":"test-RIC-1",
"allocated_host":"cscale-82-140.robinsystems.com",
"allocated_host_public_ip":"10.9.82.140",
"cpu":{
"max":1,
"min":0,
"reserve":false
},
"sidecar_info":{
"hugepages_1g":0,
"mem":0,
"hugepages_2m":0,
"containers":[
],
"cpu":0,
"gpu":0
},
"id":6,
"role_name":"server",
"hosttags":{
"kubernetes.io\/os":[
"linux"
],
"robin.io\/robinrpool":[
"default"
],
"kubernetes.io\/arch":[
"amd64"
]
},
"pod_name":"test-ric-1-server-01",
"role":"server",
"rpoolid":1,
"status":"ONLINE",
"network":[
{
"subnet":"172.21.0.0",
"allocated_by":"system",
"allocated_ip":"172.21.26.94",
"allocated_prefix":16,
"allocated_names":[
"eth0"
],
"interfaces":1,
"driver":"calico",
"allocated_netmask":"255.255.0.0",
"ippool":"robin-default",
"name":"robin-default"
}
],
"storage":[
{
"volgrp_name":"test-RIC-1.server.01.72.1.ea297971-f931-4787-99cc-6782e026b77c",
"media":"HDD",
"stordriver":{
"media":"HDD",
"protection":0,
"faultdomain":"host",
"type":"das"
},
"workload":0,
"type":"data",
"snapshot_space_limit":214748365,
"faultdomain":"host",
"name":"test-RIC-1.server.01.data.1.382f1ad5-1294-4e24-8297-9c6025eacfe5",
"blocksize":4096,
"layout":"round-robin",
"disk_tags":{
},
"allocated":{
"media":72,
"volumeid":"8",
"priority":2,
"genkey":1596663220770472,
"grpid":8,
"partitions":0,
"snapshot_space_limit":214748365,
"name":"test-RIC-1.server.01.data.1.382f1ad5-1294-4e24-8297-9c6025eacfe5",
"current_snapshot":"active_snap",
"params":{
},
"stordriver":{
"media":"HDD",
"protection":0,
"faultdomain":"host",
"type":"das"
},
"next_backupid":1,
"appname":"default",
"vtype":0,
"resource_poolid":1,
"current_snapshotid":1,
"block_size":4096,
"size":1073741824,
"replication":1,
"multinode_mounting":false,
"appid":1,
"next_snapshotid":2,
"protection":0,
"compression":0,
"slice_size":1073741824,
"qgroupid":8
},
"pvcpolicy":"create",
"fstype":"ext4",
"snap_reserved":20,
"size":1073741824,
"lvm_vol_count":"0",
"lvm_type":"None",
"encryption":"none",
"protection":0,
"compression":"disabled",
"vol_ns":"t001-u000003",
"replication":1,
"path":"\/data",
"k8s_name":"test-ric-1-server-01-data-1-382f1ad5"
},
{
"volgrp_name":"test-RIC-1.server.01.72.1.1e483fd0-2d5c-434c-aef0-91a87796977a",
"media":"HDD",
"stordriver":{
"media":"HDD",
"protection":0,
"faultdomain":"host",
"type":"das"
},
"workload":0,
"type":"block",
"snapshot_space_limit":214748365,
"faultdomain":"host",
"name":"test-RIC-1.server.01.block.1.1053eaeb-4542-42a5-a173-d69a76703ead",
"blocksize":4096,
"layout":"round-robin",
"disk_tags":{
},
"allocated":{
"media":72,
"volumeid":"9",
"priority":2,
"genkey":1596663220787432,
"grpid":9,
"partitions":0,
"snapshot_space_limit":214748365,
"name":"test-RIC-1.server.01.block.1.1053eaeb-4542-42a5-a173-d69a76703ead",
"current_snapshot":"active_snap",
"params":{
},
"stordriver":{
"media":"HDD",
"protection":0,
"faultdomain":"host",
"type":"das"
},
"next_backupid":1,
"appname":"default",
"vtype":0,
"resource_poolid":1,
"current_snapshotid":1,
"block_size":4096,
"size":1073741824,
"replication":1,
"multinode_mounting":false,
"appid":1,
"next_snapshotid":2,
"protection":0,
"compression":0,
"slice_size":1073741824,
"qgroupid":9
},
"pvcpolicy":"create",
"fstype":"raw",
"snap_reserved":20,
"size":1073741824,
"replication":1,
"lvm_type":"None",
"encryption":"none",
"protection":0,
"compression":"disabled",
"vol_ns":"t001-u000003",
"lvm_vol_count":"0",
"path":"\/dev\/rda",
"k8s_name":"test-ric-1-server-01-block-1-1053eaeb"
}
],
"cm_keys":[
"ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDgHRR3k5onnh+hjqpoW\/oLkr37GOs2f8FQVDJUHHrDeB+\/cn9c\/nez4lu9J0FkCe+mQwhnuiCicunZEjVZOWpIvjxblbw6Lh7ZkN+o5mOkcxCayrp3fDFnR1PerJJhRPnJU60zxFYbAGPrQtCywQ+b7J9hLtNaqCBf9eAwVWiLSEcFs0SkrjXjFjXOTCaq8b45AWSYc6ZxhzMsFTkTF3C37rTmEGIijmDvUbq1HRGXtQ2YZrlo\/yjJqn8wk8E+cw+Sh\/PEsudaVzoZRqyQ\/lsWBt\/+0nFON8pYttyXPZjKhuGDB5QNtUZ4kgvzDfr1TF1XEXHfo2PdsswRkQ4rU8bF root@cscale-82-140"
],
"env":{
"ENABLE_SSH":{
"value":true,
"type":"boolean"
},
"ROOT_PASSWORD":{
"value":"",
"type":"password"
},
"allocated":{
"K8S_NODE":"cscale-82-140",
"ROBINHOST":"cscale-82-140.robinsystems.com",
"POD_NAME":"test-ric-1-server-01",
"ROOT_PASSWORD":"",
"ENABLE_SSH":true,
"ROBINHOST_TAG_ROBINRPOOL":"default",
"ROBINHOST_TAG_KUBERNETES.IO-ARCH":"amd64",
"ROBINHOST_TAG_KUBERNETES.IO-OS":"linux",
"POD_NS":"t001-u000003",
"DOCKER_OPTS":"-v \/sys\/fs\/cgroup:\/sys\/fs\/cgroup --cap-add=SYS_ADMIN"
},
"DOCKER_OPTS":{
"value":"-v \/sys\/fs\/cgroup:\/sys\/fs\/cgroup --cap-add=SYS_ADMIN",
"type":"text"
}
},
"appid":6,
"root_fs":"\/usr\/local\/robin\/instances\/test-ric-1-server-01.t001-u000003.svc.cluster.local",
"enable_hooklogs":true,
"bundle_object_id":"f972a5725d1bfe2671a79d61856f872a",
"numa_allocations":{
"0":{
"hugepages_1g_used":0,
"hugepages_2m_used":0,
"gpu_used":0,
"isol_shared_cores_used":0,
"non_isol_cores_used":1,
"mem_used":209715200,
"isol_dedicated_cores_used":0
}
},
"utime":1596663233,
"volume_groups":[
{
"layout":"round-robin",
"volumes":[
"test-RIC-1.server.01.data.1.382f1ad5-1294-4e24-8297-9c6025eacfe5"
],
"media":"HDD",
"device_sets":[
{
"devices":[
{
"tags":{
},
"pused":1107296256,
"allocated_slices":2,
"type":"HDD",
"state":"READY",
"aslices":29,
"slices":77,
"stormgr_id":1,
"max_throughput_intensive_vols_per_disk":1,
"write_unit":4096,
"host":"cscale-82-140.robinsystems.com",
"role":"Storage",
"protected":0,
"devpath":"\/dev\/disk\/by-id\/scsi-3600224804c48fd7e16c608dea0919064",
"reattachable":0,
"score":84,
"psize":107374182400,
"max_volumes_per_disk":10,
"wwn":"0x600224804c48fd7e16c608dea0919064",
"capacity":107374182400,
"hostname":"cscale-82-140.robinsystems.com",
"max_latency_sensitive_vols_per_disk":2
}
],
"name":"test-RIC-1.server.01.72.1.ea297971-f931-4787-99cc-6782e026b77c.0.1e8feb41-fd42-4409-b8c1-751331febdc1",
"stormgr_id":8
}
],
"rpoolid":1,
"name":"test-RIC-1.server.01.72.1.ea297971-f931-4787-99cc-6782e026b77c",
"replicas":1,
"stormgr_id":8
},
{
"layout":"round-robin",
"volumes":[
"test-RIC-1.server.01.block.1.1053eaeb-4542-42a5-a173-d69a76703ead"
],
"media":"HDD",
"device_sets":[
{
"devices":[
{
"tags":{
},
"pused":1107296256,
"allocated_slices":2,
"type":"HDD",
"state":"READY",
"aslices":29,
"slices":77,
"stormgr_id":1,
"max_throughput_intensive_vols_per_disk":1,
"write_unit":4096,
"host":"cscale-82-140.robinsystems.com",
"role":"Storage",
"protected":0,
"devpath":"\/dev\/disk\/by-id\/scsi-3600224804c48fd7e16c608dea0919064",
"reattachable":0,
"score":84,
"psize":107374182400,
"max_volumes_per_disk":10,
"wwn":"0x600224804c48fd7e16c608dea0919064",
"capacity":107374182400,
"hostname":"cscale-82-140.robinsystems.com",
"max_latency_sensitive_vols_per_disk":2
}
],
"name":"test-RIC-1.server.01.72.1.1e483fd0-2d5c-434c-aef0-91a87796977a.0.5bf728c4-ea26-4e0f-82d7-c584fcf0bd9a",
"stormgr_id":9
}
],
"rpoolid":1,
"name":"test-RIC-1.server.01.72.1.1e483fd0-2d5c-434c-aef0-91a87796977a",
"replicas":1,
"stormgr_id":9
}
],
"bundleid":3,
"vnodehooks":{
"postcreate":"bash postcreate.sh"
},
"mem":{
"size":209715200,
"hugepages_1g":0,
"hugepages_2m":0
},
"enable_portmapping":true,
"state":"STARTED",
"name":"test-RIC-1.server.01",
"k8s_provider":"robin",
"ctime":1596663233,
"vnodeid":6,
"allocated":{
"zoneid":1596601846,
"nodename":"cscale-82-140",
"nodeid":1,
"zonename":"default"
},
"image":{
"init_mode":false,
"version":"7",
"registry_hostname":"",
"entrypoint":"entry.sh",
"name":"robinsys\/centos",
"engine":"docker",
"registry_port":""
},
"calico_inuse":true,
"enable_metrics":true,
"bundle_path":"\/usr\/local\/robin\/collections\/file-collection-1596578146092\/1596663217668\/RIC-1.5",
"vnodehookargs":{
"postcreate":[
]
},
"pod_ns":"t001-u000003",
"allocated_host_public_hostname":"cscale-82-140.robinsystems.com",
"allocated_host_type":"physical",
"hostname":"test-ric-1-server-01.t001-u000003.svc.cluster.local",
"host_ip":"172.21.26.94",
"restart_on_qoscfg":true,
"engine":"docker",
"gpu":{
"max":0,
"min":0
}
}
],
"name":"server",
"display_name":"server",
"restart_on_qoscfg":true,
"volume_groups":[
],
"image":{
"init_mode":false,
"version":"7",
"registry_hostname":"",
"entrypoint":"entry.sh",
"name":"robinsys\/centos",
"engine":"docker",
"registry_port":""
}
}
],
"bundle_path":"\/usr\/local\/robin\/collections\/file-collection-1596578146092\/1596663217668\/RIC-1.5",
"username":"robin",
"robin_version":"5.3.0-171",
"enable_hooklogs":true,
"bundle_object_id":"f972a5725d1bfe2671a79d61856f872a",
"bundleid":3,
"rpool":"default",
"snapshot":"enabled"
},
"vnodes":[
"test-RIC-1.server.01"
],
"repos":[
],
"parent_app":"",
"app_kind":"robin",
"appcfg_autopilot":true,
"bundleid":3,
"backup_state":"Hydrated",
"storagerepos":[
],
"gpu":0
}
10.12. Stop a Robin Application¶
Issue the following command to stop an application:
# robin app stop [<app_name>]
--all
|
Application instance name |
|
Stop all applications |
Example:
# robin app stop mysql --wait
Job: 177 Name: ApplicationStop State: VALIDATED Error: 0
Job: 177 Name: ApplicationStop State: WAITING Error: 0
Job: 177 Name: ApplicationStop State: COMPLETED Error: 0
Note
The robin app stop command can only be used with Robin Applications.
Stops a Robin bundle based application that is currently running.
End Point: /api/v3/robin_server/apps/<app_name>
Method: PUT
URL Parameters: None
Data Parameters:
action: stop- This mandatory field within the payload specifies that the stop operation is to be performed.
Port: RCM Port (default value is 29442)
Headers:
Authorization: <auth_token>: Authorization token to identify which user is sending the request. The token can be acquired from the login API.
Success Response Code: 202
Error Response Code: 500 (Internal Server Error), 404 (Not Found Error), 401 (Unauthorized Error), 400 (Invalid API Usage Error)
Example Response:
Output
{
"plan":{
"robin_version":"5.3.1-182",
"auto_relocate":true,
"pvcpolicy":"create",
"enable_hooklogs":true,
"zoneid":1597147518,
"planid":712,
"content_id":"a360b352c8c800e7f1af4075bb3320a4",
"name":"demo",
"roles":[
{
"name":"server",
"display_name":"server",
"vnodes":[
{
"allocated_host":"cscale-82-140.robinsystems.com",
"cm_keys":[
"ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDN8WYsAfs0+a1zzAIWIVV5MrZUaur688E08BL7fm+1uBFjBRPEevwrYrNFL7ebjJxYuB1R3WR+IX8Mmz7CiMDvfEiAQL1Ihj4GZ32WSqzZ7MN15UJK4DQWY7sU++VIusyPUj5goVS2mPj0k4zhheNOlC8XaaHgyUq+NjHHDZF5B4mX7huWfM+kC4u5nCvajoHdfeOse4e1n5RlXtlKRqzBbIma6w8Ej32qFxRLvp4lUXzCylYHBLGH42CKWvtxvETwJUb1kIW9DExSnD+u5fd4Dc2D98\/SY79OO4+aa7GA7JV7412S5kWbtq5cpnkDlvhon\/XzLVQlIqIiAJ6ukVmx root@cscale-82-140"
],
"enable_portmapping":true,
"hostname":"demo-server-01.t001-u000003.svc.cluster.local",
"k8s_provider":"robin",
"appid":47,
"vnodehookargs":{
"postcreate":[
]
},
"numa_allocations":{
"0":{
"isol_shared_cores_used":0,
"hugepages_2m_used":0,
"hugepages_1g_used":0,
"gpu_used":0,
"mem_used":209715200,
"non_isol_cores_used":1,
"isol_dedicated_cores_used":0
}
},
"pod_ns":"t001-u000003",
"storage":[
{
"type":"data",
"lvm_type":"None",
"size":1073741824,
"stordriver":{
"type":"das",
"faultdomain":"host",
"protection":0,
"media":"HDD"
},
"media":"HDD",
"disk_tags":{
},
"path":"\/data",
"vol_ns":"t001-u000003",
"snapshot_space_limit":214748365,
"fstype":"ext4",
"protection":0,
"workload":0,
"name":"demo.server.01.data.1.4589956b-3709-42f1-812d-6eeb1be3b947",
"blocksize":4096,
"layout":"round-robin",
"pvcpolicy":"create",
"faultdomain":"host",
"lvm_vol_count":"0",
"allocated":{
"partitions":0,
"volumeid":"161",
"params":{
},
"media":72,
"size":1073741824,
"stordriver":{
"type":"das",
"faultdomain":"host",
"protection":0,
"media":"HDD"
},
"block_size":4096,
"current_snapshot":"active_snap",
"multinode_mounting":false,
"snapshot_space_limit":214748365,
"slice_size":1073741824,
"protection":0,
"next_backupid":1,
"name":"demo.server.01.data.1.4589956b-3709-42f1-812d-6eeb1be3b947",
"next_snapshotid":2,
"qgroupid":161,
"genkey":1597467855202873,
"appname":"default",
"grpid":160,
"resource_poolid":1,
"replication":1,
"vtype":0,
"current_snapshotid":1,
"compression":0,
"appid":1,
"priority":2
},
"replication":1,
"snap_reserved":20,
"encryption":"none",
"compression":"disabled",
"volgrp_name":"demo.server.01.72.1.8f528537-0a21-49d0-9f4a-75ed17559bcd",
"k8s_name":"demo-server-01-data-1-4589956b"
},
{
"type":"block",
"lvm_type":"None",
"size":1073741824,
"stordriver":{
"type":"das",
"faultdomain":"host",
"protection":0,
"media":"HDD"
},
"media":"HDD",
"disk_tags":{
},
"path":"\/dev\/rda",
"vol_ns":"t001-u000003",
"snapshot_space_limit":214748365,
"fstype":"raw",
"protection":0,
"workload":0,
"name":"demo.server.01.block.1.13a9b1b5-8187-4e2d-8a63-2479d5602e34",
"blocksize":4096,
"layout":"round-robin",
"pvcpolicy":"create",
"faultdomain":"host",
"lvm_vol_count":"0",
"allocated":{
"partitions":0,
"volumeid":"160",
"params":{
},
"media":72,
"size":1073741824,
"stordriver":{
"type":"das",
"faultdomain":"host",
"protection":0,
"media":"HDD"
},
"block_size":4096,
"current_snapshot":"active_snap",
"multinode_mounting":false,
"snapshot_space_limit":214748365,
"slice_size":1073741824,
"protection":0,
"next_backupid":1,
"name":"demo.server.01.block.1.13a9b1b5-8187-4e2d-8a63-2479d5602e34",
"next_snapshotid":2,
"qgroupid":162,
"genkey":1597467855198470,
"appname":"default",
"grpid":161,
"resource_poolid":1,
"replication":1,
"vtype":0,
"current_snapshotid":1,
"compression":0,
"appid":1,
"priority":2
},
"replication":1,
"snap_reserved":20,
"encryption":"none",
"compression":"disabled",
"volgrp_name":"demo.server.01.72.1.ff9de003-4425-425a-ac04-db91540ee43a",
"k8s_name":"demo-server-01-block-1-13a9b1b5"
}
],
"id":80,
"utime":1597467867,
"host_ip":"172.21.24.156",
"restart_on_qoscfg":true,
"hosttags":{
"robin.io\/robinrpool":[
"default"
],
"kubernetes.io\/os":[
"linux"
],
"kubernetes.io\/arch":[
"amd64"
]
},
"network":[
{
"name":"robin-default",
"allocated_ip":"172.21.24.156",
"allocated_names":[
"eth0"
],
"allocated_by":"system",
"interfaces":1,
"subnet":"172.21.0.0",
"allocated_prefix":16,
"driver":"calico",
"allocated_netmask":"255.255.0.0",
"ippool":"robin-default"
}
],
"calico_inuse":true,
"enable_metrics":true,
"bundleid":1,
"appname":"demo",
"allocated":{
"zonename":"default",
"nodeid":1,
"zoneid":1597147518,
"nodename":"cscale-82-140"
},
"restart_num":15,
"volume_groups":[
{
"volumes":[
"demo.server.01.data.1.4589956b-3709-42f1-812d-6eeb1be3b947"
],
"layout":"round-robin",
"media":"HDD",
"replicas":1,
"rpoolid":1,
"device_sets":[
{
"name":"demo.server.01.72.1.8f528537-0a21-49d0-9f4a-75ed17559bcd.0.9e88d02c-3d16-4c05-89ff-29a4e2f2204a",
"devices":[
{
"max_throughput_intensive_vols_per_disk":1,
"max_latency_sensitive_vols_per_disk":2,
"tags":{
},
"hostname":"cscale-82-140.robinsystems.com",
"score":96,
"allocated_slices":2,
"reattachable":0,
"stormgr_id":2,
"protected":0,
"slices":77,
"max_volumes_per_disk":10,
"aslices":5,
"psize":107374182400,
"write_unit":4096,
"type":"HDD",
"devpath":"\/dev\/disk\/by-id\/scsi-3600224804c48fd7e16c608dea0919064",
"wwn":"0x600224804c48fd7e16c608dea0919064",
"pused":234881024,
"host":"cscale-82-140.robinsystems.com",
"capacity":107374182400,
"role":"Storage",
"state":"READY"
}
],
"stormgr_id":236
}
],
"name":"demo.server.01.72.1.8f528537-0a21-49d0-9f4a-75ed17559bcd",
"stormgr_id":160
},
{
"volumes":[
"demo.server.01.block.1.13a9b1b5-8187-4e2d-8a63-2479d5602e34"
],
"layout":"round-robin",
"media":"HDD",
"replicas":1,
"rpoolid":1,
"device_sets":[
{
"name":"demo.server.01.72.1.ff9de003-4425-425a-ac04-db91540ee43a.0.64d7adca-97f0-4ed4-9e98-f81e7557b437",
"devices":[
{
"max_throughput_intensive_vols_per_disk":1,
"max_latency_sensitive_vols_per_disk":2,
"tags":{
},
"hostname":"cscale-82-140.robinsystems.com",
"score":96,
"allocated_slices":2,
"reattachable":0,
"stormgr_id":2,
"protected":0,
"slices":77,
"max_volumes_per_disk":10,
"aslices":5,
"psize":107374182400,
"write_unit":4096,
"type":"HDD",
"devpath":"\/dev\/disk\/by-id\/scsi-3600224804c48fd7e16c608dea0919064",
"wwn":"0x600224804c48fd7e16c608dea0919064",
"pused":234881024,
"host":"cscale-82-140.robinsystems.com",
"capacity":107374182400,
"role":"Storage",
"state":"READY"
}
],
"stormgr_id":237
}
],
"name":"demo.server.01.72.1.ff9de003-4425-425a-ac04-db91540ee43a",
"stormgr_id":161
}
],
"rpoolid":1,
"sidecar_info":{
"mem":0,
"cpu":0,
"containers":[
],
"hugepages_1g":0,
"hugepages_2m":0,
"gpu":0
},
"role":"server",
"vnodehooks":{
"postcreate":"bash postcreate.sh"
},
"allocated_host_type":"physical",
"state":"STARTED",
"name":"demo.server.01",
"enable_hooklogs":true,
"allocated_host_public_hostname":"cscale-82-140.robinsystems.com",
"pod_name":"demo-server-01",
"engine":"docker",
"cpu":{
"min":0,
"max":1,
"reserve":false
},
"role_name":"server",
"vnodeid":80,
"allocated_host_public_ip":"10.9.82.140",
"bundle_path":"\/usr\/local\/robin\/collections\/file-collection-1597122699552\/1597122985597\/centos-1.0",
"root_fs":"\/usr\/local\/robin\/instances\/demo-server-01.t001-u000003.svc.cluster.local",
"mem":{
"size":209715200,
"hugepages_2m":0,
"hugepages_1g":0
},
"image":{
"name":"robinsys\/centos",
"engine":"docker",
"registry_hostname":"",
"version":"7",
"registry_port":"",
"entrypoint":"entry.sh",
"init_mode":false
},
"env":{
"DOCKER_OPTS":{
"value":"-v \/sys\/fs\/cgroup:\/sys\/fs\/cgroup --cap-add=SYS_ADMIN",
"type":"text"
},
"ROOT_PASSWORD":{
"value":"",
"type":"password"
},
"allocated":{
"ROBINHOST":"cscale-82-140.robinsystems.com",
"ROBINHOST_TAG_KUBERNETES.IO-OS":"linux",
"ROBINHOST_TAG_KUBERNETES.IO-ARCH":"amd64",
"DOCKER_OPTS":"-v \/sys\/fs\/cgroup:\/sys\/fs\/cgroup --cap-add=SYS_ADMIN",
"ROBINHOST_TAG_ROBINRPOOL":"default",
"POD_NAME":"demo-server-01",
"POD_NS":"t001-u000003",
"ROOT_PASSWORD":"",
"K8S_NODE":"cscale-82-140",
"ENABLE_SSH":true
},
"ENABLE_SSH":{
"value":true,
"type":"boolean"
}
},
"ctime":1597467867,
"service_uids":[
],
"bundle_object_id":"a360b352c8c800e7f1af4075bb3320a4",
"gpu":{
"min":0,
"max":0
}
}
],
"image":{
"name":"robinsys\/centos",
"engine":"docker",
"registry_hostname":"",
"version":"7",
"registry_port":"",
"entrypoint":"entry.sh",
"init_mode":false
},
"volume_groups":[
],
"qgroups":{
"data":{
"wr_min_window":500,
"wr_weight":1,
"rd_min_window":500,
"enabled":false,
"wr_max_iops":2000000,
"wr_min_iops":0,
"priority":1,
"rd_max_iops":2000000,
"rd_weight":1,
"rd_min_iops":0
},
"block":{
"wr_min_window":500,
"wr_weight":1,
"rd_min_window":500,
"enabled":false,
"wr_max_iops":2000000,
"wr_min_iops":0,
"priority":1,
"rd_max_iops":2000000,
"rd_weight":1,
"rd_min_iops":0
}
},
"restart_on_qoscfg":true
}
],
"bundle_object_id":"a360b352c8c800e7f1af4075bb3320a4",
"tenant":"Administrators",
"bundleid":1,
"snapshot":"enabled",
"id":47,
"bundle_path":"\/usr\/local\/robin\/collections\/file-collection-1597122699552\/1597122985597\/centos-1.0",
"from_template":null,
"restart_num":15,
"clone":"enabled",
"version":"7",
"namespace":"t001-u000003",
"rpool":"default",
"rpoolid":1,
"username":"robin",
"enable_metrics":true,
"app_ns":"t001-u000003"
},
"jobid":1896
}
10.13. Start a Robin Application¶
Issue the following command to stop an application:
# robin app start [<app_name>]
--all
|
Application instance name |
|
Start all applications |
Example:
# robin app start mysql --wait
Job: 174 Name: ApplicationStart State: VALIDATED Error: 0
Job: 174 Name: ApplicationStart State: WAITING Error: 0
Job: 174 Name: ApplicationStart State: COMPLETED Error: 0
Note
The robin app start command can only be used with Robin Applications.
Starts a Robin bundle based application that is currently not running.
End Point: /api/v3/robin_server/apps/<app_name>
Method: PUT
URL Parameters: None
Data Parameters:
action: start- This mandatory field within the payload specifies that the start operation is to be performed.
Port: RCM Port (default value is 29442)
Headers:
Authorization: <auth_token>: Authorization token to identify which user is sending the request. The token can be acquired from the login API.
Success Response Code: 202
Error Response Code: 500 (Internal Server Error), 404 (Not Found Error), 401 (Unauthorized Error), 400 (Invalid API Usage Error)
Example Response:
Output
{
"plan":{
"orig_config":{
"robin_version":"5.3.1-182",
"auto_relocate":true,
"pvcpolicy":"create",
"enable_hooklogs":true,
"zoneid":1597147518,
"planid":712,
"content_id":"a360b352c8c800e7f1af4075bb3320a4",
"name":"demo",
"roles":[
{
"name":"server",
"volume_groups":[
],
"vnodes":[
{
"allocated_host":"cscale-82-140.robinsystems.com",
"cm_keys":[
"ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDN8WYsAfs0+a1zzAIWIVV5MrZUaur688E08BL7fm+1uBFjBRPEevwrYrNFL7ebjJxYuB1R3WR+IX8Mmz7CiMDvfEiAQL1Ihj4GZ32WSqzZ7MN15UJK4DQWY7sU++VIusyPUj5goVS2mPj0k4zhheNOlC8XaaHgyUq+NjHHDZF5B4mX7huWfM+kC4u5nCvajoHdfeOse4e1n5RlXtlKRqzBbIma6w8Ej32qFxRLvp4lUXzCylYHBLGH42CKWvtxvETwJUb1kIW9DExSnD+u5fd4Dc2D98\/SY79OO4+aa7GA7JV7412S5kWbtq5cpnkDlvhon\/XzLVQlIqIiAJ6ukVmx root@cscale-82-140"
],
"enable_portmapping":true,
"hostname":"demo-server-01.t001-u000003.svc.cluster.local",
"vnodeid":80,
"appid":47,
"vnodehookargs":{
"postcreate":[
]
},
"numa_allocations":{
"0":{
"isol_shared_cores_used":0,
"gpu_used":0,
"hugepages_1g_used":0,
"hugepages_2m_used":0,
"mem_used":209715200,
"non_isol_cores_used":1,
"isol_dedicated_cores_used":0
}
},
"pod_ns":"t001-u000003",
"storage":[
{
"pvcpolicy":"create",
"lvm_type":"None",
"size":1073741824,
"stordriver":{
"media":"HDD",
"faultdomain":"host",
"protection":0,
"type":"das"
},
"disk_tags":{
},
"path":"\/data",
"vol_ns":"t001-u000003",
"snapshot_space_limit":214748365,
"fstype":"ext4",
"replication":1,
"workload":0,
"name":"demo.server.01.data.1.4589956b-3709-42f1-812d-6eeb1be3b947",
"blocksize":4096,
"compression":"disabled",
"type":"data",
"media":"HDD",
"faultdomain":"host",
"lvm_vol_count":"0",
"allocated":{
"partitions":0,
"volumeid":"161",
"multinode_mounting":false,
"media":72,
"size":1073741824,
"stordriver":{
"media":"HDD",
"faultdomain":"host",
"protection":0,
"type":"das"
},
"block_size":4096,
"current_snapshot":"active_snap",
"params":{
},
"snapshot_space_limit":214748365,
"slice_size":1073741824,
"replication":1,
"next_backupid":1,
"name":"demo.server.01.data.1.4589956b-3709-42f1-812d-6eeb1be3b947",
"next_snapshotid":2,
"qgroupid":161,
"priority":2,
"genkey":1597467855202873,
"appname":"default",
"grpid":160,
"protection":0,
"vtype":0,
"current_snapshotid":1,
"compression":0,
"appid":1,
"resource_poolid":1
},
"protection":0,
"snap_reserved":20,
"encryption":"none",
"layout":"round-robin",
"volgrp_name":"demo.server.01.72.1.8f528537-0a21-49d0-9f4a-75ed17559bcd",
"k8s_name":"demo-server-01-data-1-4589956b"
},
{
"pvcpolicy":"create",
"lvm_type":"None",
"size":1073741824,
"stordriver":{
"media":"HDD",
"faultdomain":"host",
"protection":0,
"type":"das"
},
"disk_tags":{
},
"path":"\/dev\/rda",
"vol_ns":"t001-u000003",
"snapshot_space_limit":214748365,
"fstype":"raw",
"replication":1,
"workload":0,
"name":"demo.server.01.block.1.13a9b1b5-8187-4e2d-8a63-2479d5602e34",
"blocksize":4096,
"compression":"disabled",
"type":"block",
"media":"HDD",
"faultdomain":"host",
"lvm_vol_count":"0",
"allocated":{
"partitions":0,
"volumeid":"160",
"multinode_mounting":false,
"media":72,
"size":1073741824,
"stordriver":{
"media":"HDD",
"faultdomain":"host",
"protection":0,
"type":"das"
},
"block_size":4096,
"current_snapshot":"active_snap",
"params":{
},
"snapshot_space_limit":214748365,
"slice_size":1073741824,
"replication":1,
"next_backupid":1,
"name":"demo.server.01.block.1.13a9b1b5-8187-4e2d-8a63-2479d5602e34",
"next_snapshotid":2,
"qgroupid":162,
"priority":2,
"genkey":1597467855198470,
"appname":"default",
"grpid":161,
"protection":0,
"vtype":0,
"current_snapshotid":1,
"compression":0,
"appid":1,
"resource_poolid":1
},
"protection":0,
"snap_reserved":20,
"encryption":"none",
"layout":"round-robin",
"volgrp_name":"demo.server.01.72.1.ff9de003-4425-425a-ac04-db91540ee43a",
"k8s_name":"demo-server-01-block-1-13a9b1b5"
}
],
"id":80,
"utime":1597467867,
"name":"demo.server.01",
"restart_on_qoscfg":true,
"hosttags":{
"kubernetes.io\/os":[
"linux"
],
"robin.io\/robinrpool":[
"default"
],
"kubernetes.io\/arch":[
"amd64"
]
},
"network":[
{
"name":"robin-default",
"driver":"calico",
"allocated_ip":"172.21.24.156",
"allocated_netmask":"255.255.0.0",
"interfaces":1,
"ippool":"robin-default",
"allocated_by":"system",
"allocated_prefix":16,
"allocated_names":[
"eth0"
],
"subnet":"172.21.0.0"
}
],
"calico_inuse":true,
"enable_metrics":true,
"bundleid":1,
"appname":"demo",
"allocated":{
"zonename":"default",
"nodeid":1,
"zoneid":1597147518,
"nodename":"cscale-82-140"
},
"restart_num":15,
"volume_groups":[
{
"volumes":[
"demo.server.01.data.1.4589956b-3709-42f1-812d-6eeb1be3b947"
],
"device_sets":[
{
"name":"demo.server.01.72.1.8f528537-0a21-49d0-9f4a-75ed17559bcd.0.9e88d02c-3d16-4c05-89ff-29a4e2f2204a",
"devices":[
{
"max_throughput_intensive_vols_per_disk":1,
"max_latency_sensitive_vols_per_disk":2,
"tags":{
},
"hostname":"cscale-82-140.robinsystems.com",
"score":96,
"allocated_slices":2,
"reattachable":0,
"stormgr_id":2,
"protected":0,
"slices":77,
"max_volumes_per_disk":10,
"aslices":5,
"psize":107374182400,
"write_unit":4096,
"type":"HDD",
"devpath":"\/dev\/disk\/by-id\/scsi-3600224804c48fd7e16c608dea0919064",
"wwn":"0x600224804c48fd7e16c608dea0919064",
"pused":234881024,
"host":"cscale-82-140.robinsystems.com",
"capacity":107374182400,
"role":"Storage",
"state":"READY"
}
],
"stormgr_id":236
}
],
"media":"HDD",
"replicas":1,
"rpoolid":1,
"layout":"round-robin",
"name":"demo.server.01.72.1.8f528537-0a21-49d0-9f4a-75ed17559bcd",
"stormgr_id":160
},
{
"volumes":[
"demo.server.01.block.1.13a9b1b5-8187-4e2d-8a63-2479d5602e34"
],
"device_sets":[
{
"name":"demo.server.01.72.1.ff9de003-4425-425a-ac04-db91540ee43a.0.64d7adca-97f0-4ed4-9e98-f81e7557b437",
"devices":[
{
"max_throughput_intensive_vols_per_disk":1,
"max_latency_sensitive_vols_per_disk":2,
"tags":{
},
"hostname":"cscale-82-140.robinsystems.com",
"score":96,
"allocated_slices":2,
"reattachable":0,
"stormgr_id":2,
"protected":0,
"slices":77,
"max_volumes_per_disk":10,
"aslices":5,
"psize":107374182400,
"write_unit":4096,
"type":"HDD",
"devpath":"\/dev\/disk\/by-id\/scsi-3600224804c48fd7e16c608dea0919064",
"wwn":"0x600224804c48fd7e16c608dea0919064",
"pused":234881024,
"host":"cscale-82-140.robinsystems.com",
"capacity":107374182400,
"role":"Storage",
"state":"READY"
}
],
"stormgr_id":237
}
],
"media":"HDD",
"replicas":1,
"rpoolid":1,
"layout":"round-robin",
"name":"demo.server.01.72.1.ff9de003-4425-425a-ac04-db91540ee43a",
"stormgr_id":161
}
],
"rpoolid":1,
"sidecar_info":{
"gpu":0,
"mem":0,
"cpu":0,
"containers":[
],
"hugepages_1g":0,
"hugepages_2m":0
},
"role":"server",
"vnodehooks":{
"postcreate":"bash postcreate.sh"
},
"ctime":1597467867,
"allocated_host_type":"physical",
"gpu":{
"min":0,
"max":0
},
"host_ip":"172.21.24.156",
"enable_hooklogs":true,
"allocated_host_public_hostname":"cscale-82-140.robinsystems.com",
"pod_name":"demo-server-01",
"engine":"docker",
"cpu":{
"min":0,
"max":1,
"reserve":false
},
"k8s_provider":"robin",
"allocated_host_public_ip":"10.9.82.140",
"bundle_path":"\/usr\/local\/robin\/collections\/file-collection-1597122699552\/1597122985597\/centos-1.0",
"root_fs":"\/usr\/local\/robin\/instances\/demo-server-01.t001-u000003.svc.cluster.local",
"mem":{
"size":209715200,
"hugepages_1g":0,
"hugepages_2m":0
},
"image":{
"name":"robinsys\/centos",
"engine":"docker",
"registry_hostname":"",
"version":"7",
"registry_port":"",
"entrypoint":"entry.sh",
"init_mode":false
},
"env":{
"DOCKER_OPTS":{
"value":"-v \/sys\/fs\/cgroup:\/sys\/fs\/cgroup --cap-add=SYS_ADMIN",
"type":"text"
},
"ROOT_PASSWORD":{
"value":"",
"type":"password"
},
"allocated":{
"ROBINHOST":"cscale-82-140.robinsystems.com",
"DOCKER_OPTS":"-v \/sys\/fs\/cgroup:\/sys\/fs\/cgroup --cap-add=SYS_ADMIN",
"ROBINHOST_TAG_KUBERNETES.IO-ARCH":"amd64",
"ENABLE_SSH":true,
"ROBINHOST_TAG_KUBERNETES.IO-OS":"linux",
"ROBINHOST_TAG_ROBINRPOOL":"default",
"POD_NAME":"demo-server-01",
"POD_NS":"t001-u000003",
"ROOT_PASSWORD":"",
"K8S_NODE":"cscale-82-140"
},
"ENABLE_SSH":{
"value":true,
"type":"boolean"
}
},
"state":"STARTED",
"service_uids":[
],
"bundle_object_id":"a360b352c8c800e7f1af4075bb3320a4",
"role_name":"server"
}
],
"image":{
"name":"robinsys\/centos",
"engine":"docker",
"registry_hostname":"",
"version":"7",
"registry_port":"",
"entrypoint":"entry.sh",
"init_mode":false
},
"display_name":"server",
"qgroups":{
"data":{
"wr_weight":1,
"wr_min_window":500,
"rd_min_iops":0,
"enabled":false,
"wr_max_iops":2000000,
"rd_max_iops":2000000,
"priority":1,
"rd_min_window":500,
"rd_weight":1,
"wr_min_iops":0
},
"block":{
"wr_weight":1,
"wr_min_window":500,
"rd_min_iops":0,
"enabled":false,
"wr_max_iops":2000000,
"rd_max_iops":2000000,
"priority":1,
"rd_min_window":500,
"rd_weight":1,
"wr_min_iops":0
}
},
"restart_on_qoscfg":true
}
],
"bundle_object_id":"a360b352c8c800e7f1af4075bb3320a4",
"tenant":"Administrators",
"bundleid":1,
"snapshot":"enabled",
"id":47,
"bundle_path":"\/usr\/local\/robin\/collections\/file-collection-1597122699552\/1597122985597\/centos-1.0",
"from_template":null,
"restart_num":15,
"clone":"enabled",
"version":"7",
"namespace":"t001-u000003",
"rpool":"default",
"rpoolid":1,
"username":"robin",
"enable_metrics":true,
"app_ns":"t001-u000003"
},
"kind":"robin",
"name":"demo",
"opcode":2,
"namespace":"t001-u000003",
"current_user":{
"tenants":[
"Administrators"
],
"session_expires":"2020-08-15T09:44:41",
"tenant_role":"superadmin",
},
"user_contexts":[
"robin"
],
"tenant_id":1,
"user_capabilities":[
"AllSuperAdminCapabilities"
],
"ip_addr":"172.20.0.1",
"user_permissions":{
},
"user_id":3,
"namespace":"t001-u000003",
"username":"robin",
"user_context":"robin",
"tenant":"Administrators"
},
"action":"start"
},
"jobid":1899
}
10.14. Restart a Robin Application¶
Issue the following command to restart an application:
# robin app restart [<app_name>]
--all
|
Application instance name |
|
Restart all applications |
Example:
# robin app restart mysql --wait
Job: 180 Name: ApplicationStart State: VALIDATED Error: 0
Job: 180 Name: ApplicationStart State: WAITING Error: 0
Job: 180 Name: ApplicationStart State: COMPLETED Error: 0
Note
The robin app restart command can only be used with Robin Applications.
Restarts a Robin bundle based application.
End Point: /api/v3/robin_server/apps/<app_name>
Method: PUT
URL Parameters: None
Data Parameters:
action: redeploy- This mandatory field within the payload specifies that the restart operation is to be performed.
Port: RCM Port (default value is 29442)
Headers:
Authorization: <auth_token>: Authorization token to identify which user is sending the request. The token can be acquired from the login API.
Success Response Code: 202
Error Response Code: 500 (Internal Server Error), 404 (Not Found Error), 401 (Unauthorized Error), 400 (Invalid API Usage Error)
Example Response:
Output
{
"plan":{
"orig_config":{
"robin_version":"5.3.1-182",
"auto_relocate":true,
"pvcpolicy":"create",
"enable_hooklogs":true,
"zoneid":1597147518,
"planid":713,
"content_id":"a360b352c8c800e7f1af4075bb3320a4",
"name":"demo",
"roles":[
{
"name":"server",
"display_name":"server",
"vnodes":[
{
"allocated_host":"cscale-82-140.robinsystems.com",
"cm_keys":[
"ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDN8WYsAfs0+a1zzAIWIVV5MrZUaur688E08BL7fm+1uBFjBRPEevwrYrNFL7ebjJxYuB1R3WR+IX8Mmz7CiMDvfEiAQL1Ihj4GZ32WSqzZ7MN15UJK4DQWY7sU++VIusyPUj5goVS2mPj0k4zhheNOlC8XaaHgyUq+NjHHDZF5B4mX7huWfM+kC4u5nCvajoHdfeOse4e1n5RlXtlKRqzBbIma6w8Ej32qFxRLvp4lUXzCylYHBLGH42CKWvtxvETwJUb1kIW9DExSnD+u5fd4Dc2D98\/SY79OO4+aa7GA7JV7412S5kWbtq5cpnkDlvhon\/XzLVQlIqIiAJ6ukVmx root@cscale-82-140"
],
"enable_portmapping":true,
"hostname":"demo-server-01.t001-u000003.svc.cluster.local",
"k8s_provider":"robin",
"appid":47,
"vnodehookargs":{
"postcreate":[
]
},
"numa_allocations":{
"0":{
"isol_shared_cores_used":0,
"gpu_used":0,
"hugepages_1g_used":0,
"hugepages_2m_used":0,
"mem_used":209715200,
"non_isol_cores_used":1,
"isol_dedicated_cores_used":0
}
},
"pod_ns":"t001-u000003",
"storage":[
{
"pvcpolicy":"create",
"lvm_type":"None",
"size":1073741824,
"stordriver":{
"type":"das",
"faultdomain":"host",
"protection":0,
"media":"HDD"
},
"media":"HDD",
"disk_tags":{
},
"path":"\/data",
"vol_ns":"t001-u000003",
"snapshot_space_limit":214748365,
"fstype":"ext4",
"protection":0,
"workload":0,
"name":"demo.server.01.data.1.4589956b-3709-42f1-812d-6eeb1be3b947",
"blocksize":4096,
"layout":"round-robin",
"type":"data",
"faultdomain":"host",
"lvm_vol_count":"0",
"allocated":{
"partitions":0,
"volumeid":"161",
"params":{
},
"media":72,
"size":1073741824,
"stordriver":{
"type":"das",
"faultdomain":"host",
"protection":0,
"media":"HDD"
},
"block_size":4096,
"current_snapshot":"active_snap",
"multinode_mounting":false,
"snapshot_space_limit":214748365,
"slice_size":1073741824,
"protection":0,
"next_backupid":1,
"name":"demo.server.01.data.1.4589956b-3709-42f1-812d-6eeb1be3b947",
"next_snapshotid":2,
"qgroupid":161,
"genkey":1597467855202873,
"appname":"default",
"grpid":160,
"resource_poolid":1,
"replication":1,
"vtype":0,
"current_snapshotid":1,
"compression":0,
"appid":1,
"priority":2
},
"replication":1,
"snap_reserved":20,
"device":"\/dev\/sde",
"encryption":"none",
"compression":"disabled",
"volgrp_name":"demo.server.01.72.1.8f528537-0a21-49d0-9f4a-75ed17559bcd",
"k8s_name":"demo-server-01-data-1-4589956b"
},
{
"pvcpolicy":"create",
"lvm_type":"None",
"size":1073741824,
"stordriver":{
"type":"das",
"faultdomain":"host",
"protection":0,
"media":"HDD"
},
"media":"HDD",
"disk_tags":{
},
"path":"\/dev\/rda",
"vol_ns":"t001-u000003",
"snapshot_space_limit":214748365,
"fstype":"raw",
"protection":0,
"workload":0,
"name":"demo.server.01.block.1.13a9b1b5-8187-4e2d-8a63-2479d5602e34",
"blocksize":4096,
"layout":"round-robin",
"type":"block",
"faultdomain":"host",
"lvm_vol_count":"0",
"allocated":{
"partitions":0,
"volumeid":"160",
"params":{
},
"media":72,
"size":1073741824,
"stordriver":{
"type":"das",
"faultdomain":"host",
"protection":0,
"media":"HDD"
},
"block_size":4096,
"current_snapshot":"active_snap",
"multinode_mounting":false,
"snapshot_space_limit":214748365,
"slice_size":1073741824,
"protection":0,
"next_backupid":1,
"name":"demo.server.01.block.1.13a9b1b5-8187-4e2d-8a63-2479d5602e34",
"next_snapshotid":2,
"qgroupid":162,
"genkey":1597467855198470,
"appname":"default",
"grpid":161,
"resource_poolid":1,
"replication":1,
"vtype":0,
"current_snapshotid":1,
"compression":0,
"appid":1,
"priority":2
},
"replication":1,
"snap_reserved":20,
"device":"\/dev\/sdf",
"encryption":"none",
"compression":"disabled",
"volgrp_name":"demo.server.01.72.1.ff9de003-4425-425a-ac04-db91540ee43a",
"k8s_name":"demo-server-01-block-1-13a9b1b5"
}
],
"id":80,
"utime":1597467867,
"host_ip":"172.21.24.156",
"restart_on_qoscfg":true,
"hosttags":{
"kubernetes.io\/os":[
"linux"
],
"robin.io\/robinrpool":[
"default"
],
"kubernetes.io\/arch":[
"amd64"
]
},
"network":[
{
"name":"robin-default",
"allocated_ip":"172.21.24.156",
"allocated_names":[
"eth0"
],
"allocated_by":"system",
"interfaces":1,
"subnet":"172.21.0.0",
"driver":"calico",
"allocated_prefix":16,
"allocated_netmask":"255.255.0.0",
"ippool":"robin-default"
}
],
"calico_inuse":true,
"enable_metrics":true,
"bundleid":1,
"appname":"demo",
"allocated":{
"zonename":"default",
"nodeid":1,
"zoneid":1597147518,
"nodename":"cscale-82-140"
},
"restart_num":15,
"volume_groups":[
{
"volumes":[
"demo.server.01.data.1.4589956b-3709-42f1-812d-6eeb1be3b947"
],
"layout":"round-robin",
"media":"HDD",
"replicas":1,
"rpoolid":1,
"device_sets":[
{
"name":"demo.server.01.72.1.8f528537-0a21-49d0-9f4a-75ed17559bcd.0.9e88d02c-3d16-4c05-89ff-29a4e2f2204a",
"devices":[
{
"max_throughput_intensive_vols_per_disk":1,
"max_latency_sensitive_vols_per_disk":2,
"tags":{
},
"hostname":"cscale-82-140.robinsystems.com",
"score":96,
"allocated_slices":2,
"reattachable":0,
"stormgr_id":2,
"protected":0,
"slices":77,
"max_volumes_per_disk":10,
"aslices":5,
"psize":107374182400,
"write_unit":4096,
"type":"HDD",
"devpath":"\/dev\/disk\/by-id\/scsi-3600224804c48fd7e16c608dea0919064",
"wwn":"0x600224804c48fd7e16c608dea0919064",
"pused":234881024,
"host":"cscale-82-140.robinsystems.com",
"capacity":107374182400,
"role":"Storage",
"state":"READY"
}
],
"stormgr_id":236
}
],
"name":"demo.server.01.72.1.8f528537-0a21-49d0-9f4a-75ed17559bcd",
"stormgr_id":160
},
{
"volumes":[
"demo.server.01.block.1.13a9b1b5-8187-4e2d-8a63-2479d5602e34"
],
"layout":"round-robin",
"media":"HDD",
"replicas":1,
"rpoolid":1,
"device_sets":[
{
"name":"demo.server.01.72.1.ff9de003-4425-425a-ac04-db91540ee43a.0.64d7adca-97f0-4ed4-9e98-f81e7557b437",
"devices":[
{
"max_throughput_intensive_vols_per_disk":1,
"max_latency_sensitive_vols_per_disk":2,
"tags":{
},
"hostname":"cscale-82-140.robinsystems.com",
"score":96,
"allocated_slices":2,
"reattachable":0,
"stormgr_id":2,
"protected":0,
"slices":77,
"max_volumes_per_disk":10,
"aslices":5,
"psize":107374182400,
"write_unit":4096,
"type":"HDD",
"devpath":"\/dev\/disk\/by-id\/scsi-3600224804c48fd7e16c608dea0919064",
"wwn":"0x600224804c48fd7e16c608dea0919064",
"pused":234881024,
"host":"cscale-82-140.robinsystems.com",
"capacity":107374182400,
"role":"Storage",
"state":"READY"
}
],
"stormgr_id":237
}
],
"name":"demo.server.01.72.1.ff9de003-4425-425a-ac04-db91540ee43a",
"stormgr_id":161
}
],
"rpoolid":1,
"sidecar_info":{
"mem":0,
"cpu":0,
"containers":[
],
"gpu":0,
"hugepages_2m":0,
"hugepages_1g":0
},
"role":"server",
"vnodehooks":{
"postcreate":"bash postcreate.sh"
},
"engine":"docker",
"desired_status":"ONLINE",
"allocated_host_type":"physical",
"state":"STARTED",
"name":"demo.server.01",
"enable_hooklogs":true,
"allocated_host_public_hostname":"cscale-82-140.robinsystems.com",
"pod_name":"demo-server-01",
"jobid":1901,
"cpu":{
"min":0,
"max":1,
"reserve":false
},
"role_name":"server",
"vnodeid":80,
"allocated_host_public_ip":"10.9.82.140",
"bundle_path":"\/usr\/local\/robin\/collections\/file-collection-1597122699552\/1597122985597\/centos-1.0",
"root_fs":"\/usr\/local\/robin\/instances\/demo-server-01.t001-u000003.svc.cluster.local",
"mem":{
"size":209715200,
"hugepages_2m":0,
"hugepages_1g":0
},
"image":{
"name":"robinsys\/centos",
"engine":"docker",
"registry_hostname":"",
"version":"7",
"registry_port":"",
"entrypoint":"entry.sh",
"init_mode":false
},
"env":{
"DOCKER_OPTS":{
"value":"-v \/sys\/fs\/cgroup:\/sys\/fs\/cgroup --cap-add=SYS_ADMIN",
"type":"text"
},
"ROOT_PASSWORD":{
"value":"",
"type":"password"
},
"allocated":{
"ROBINHOST":"cscale-82-140.robinsystems.com",
"DOCKER_OPTS":"-v \/sys\/fs\/cgroup:\/sys\/fs\/cgroup --cap-add=SYS_ADMIN",
"ROBINHOST_TAG_KUBERNETES.IO-ARCH":"amd64",
"ENABLE_SSH":true,
"ROBINHOST_TAG_KUBERNETES.IO-OS":"linux",
"ROBINHOST_TAG_ROBINRPOOL":"default",
"POD_NAME":"demo-server-01",
"POD_NS":"t001-u000003",
"ROOT_PASSWORD":"",
"K8S_NODE":"cscale-82-140"
},
"ENABLE_SSH":{
"value":true,
"type":"boolean"
}
},
"ctime":1597467867,
"service_uids":[
],
"bundle_object_id":"a360b352c8c800e7f1af4075bb3320a4",
"gpu":{
"min":0,
"max":0
}
}
],
"image":{
"name":"robinsys\/centos",
"engine":"docker",
"registry_hostname":"",
"version":"7",
"registry_port":"",
"entrypoint":"entry.sh",
"init_mode":false
},
"volume_groups":[
],
"qgroups":{
"data":{
"wr_min_window":500,
"wr_weight":1,
"rd_min_window":500,
"enabled":false,
"wr_max_iops":2000000,
"wr_min_iops":0,
"priority":1,
"rd_max_iops":2000000,
"rd_weight":1,
"rd_min_iops":0
},
"block":{
"wr_min_window":500,
"wr_weight":1,
"rd_min_window":500,
"enabled":false,
"wr_max_iops":2000000,
"wr_min_iops":0,
"priority":1,
"rd_max_iops":2000000,
"rd_weight":1,
"rd_min_iops":0
}
},
"restart_on_qoscfg":true
}
],
"bundle_object_id":"a360b352c8c800e7f1af4075bb3320a4",
"tenant":"Administrators",
"bundleid":1,
"snapshot":"enabled",
"id":47,
"bundle_path":"\/usr\/local\/robin\/collections\/file-collection-1597122699552\/1597122985597\/centos-1.0",
"from_template":null,
"restart_num":15,
"clone":"enabled",
"version":"7",
"namespace":"t001-u000003",
"rpool":"default",
"rpoolid":1,
"username":"robin",
"enable_metrics":true,
"app_ns":"t001-u000003"
},
"kind":"robin",
"name":"demo",
"opcode":20,
"namespace":"t001-u000003",
"current_user":{
"tenants":[
"Administrators"
],
"session_expires":"2020-08-15T09:44:41",
"tenant_role":"superadmin",
"user_contexts":[
"robin"
],
"tenant_id":1,
"user_capabilities":[
"AllSuperAdminCapabilities"
],
"ip_addr":"172.20.0.1",
"user_permissions":{
},
"user_id":3,
"namespace":"t001-u000003",
"username":"robin",
"user_context":"robin",
"tenant":"Administrators"
},
"action":"redeploy"
},
"jobid":1902
}
10.15. Application Sharing and the Reasignment of Application Ownership¶
Each application is assigned to a user and a tenant. The user is the
application’s owner (creator) and the tenant is the tenant they were
logged into when they created the app. By default, a regular tenant
user (a user assigned the user role) can only access and manage
applications they own. There are times, however, when it might be
desirable for an application to be shared with multiple tenant users.
For example, a tenant administrator might want a group of users to
share management responsibilities for an application. To accomplish
this, the tenant admin can give each user shared access to the app
with permission to perform specific administrative tasks, such as
starting and stopping the app, creating snapshots and backups, etc.
In addition to application sharing, there are also times when the
ownership of an application needs to be reassigned from one tenant
user to another. For example, if the application’s owner needs to be
removed from the tenant.
Applications are multi-object entities consisting of the application control object and one or more instance (vnode) objects. There is a very tight coupling between these objects that requires they all be assigned to the same user and tenant. In addition to the objects making up the application, an application may have one or more snapshots or clones associated with it.
A application snapshot contains a point-in-time copy of the application’s data and operational state. Snapshot’s can be used to revert (roll back) an app to a particular point in time, or when creating an application clone.
An application clone is an application instance, however it does not exist independently. The volumes allocated for an application clone are shared with the parent app (linked by the sanpshot the clone was created from).
Requiring all application objects be assigned to the same user and tenant ensures that the user (the application’s owner) will be able to access and manage all resources associated with the application. This is especially true when it comes to app deletion. An app cannot be deleted if there are any snapshots or clones associated with it, and the app’s owner will not be able to delete them (or even see them) if they are ownd by another user. Any snapshot or clone created by a user with shared access to an app will be assigned to the same user and tenant as the app. The user creating the snapshot or clone will automatically be given shared access to the objects they created, however, so they can access it.
Note
The sharing of applications and the reassignment of their ownership is closely aligned with the sharing of namespaces. Before a user to be given access to an application, they first must be given access to the namespace the application is deployed to. Note that the sharing of a namespace is a separate operation from the sharing of an application.
When reassigning ownership of an application, the ownership of all related snapshots and application clones will also be changed.
If a user’s shared access to an app is revoked, then shared access to all snapshots and clones associated with that app will also be revoked.
An application clone must be deployed in the same namespace the parent is deployed in. Even if it’s possible for applications deployed to different namespaces to share storage volume (from a pure storage point of view), to allow it makes validity checking scenarios very complicated and error prone.
A user with shared access to an app will not automatically have access to snapshots and application clones associated with the app. They can be given shared access, however (by a tenantadmin or superadmin user).
A user with shared access to an app (and adequate share permissions) will be able to create and manage the snapshots and clones they create.
A user with shared access to an app will not be allowed to delete the app (only the app owner, a tenantadmin, or superadmin should be able to do that).
Even though there is a relationship between an app and backups crated from that app, the above ownership rule doesn’t apply. That’s because backups can exist independent of the apps they were created from, and even from the cluster they were created on.
10.15.1. Sharing an Application¶
Run the following command to share an app with one or more users:
# robin app share name [user_list]
--operations <operations>
--all-tenant-users
|
Application instance name |
|
Optional comma separated list of users the application will be shared with |
|
Comma separated list of operations the users will be allowed to perform on the shared application. To allow all valid operations to be performed, specify ‘ALL_OPERATIONS’ on the command line (default value is ‘view’) |
|
Share app with all tenant users. Note this option is required when no users are explicitly specified |
Example:
# robin app share demo robin --wait
Job: 101 Name: ApplicationShare State: PROCESSED Error: 0
Job: 101 Name: ApplicationShare State: COMPLETED Error: 0
Note
The ability to share an application is subject to Robin Role Based Access Control (RBAC). By default, only Cluster and Tenant Administrators (users assigned the superadmin or tenantadmin role for the specified tenant) have permission to do so. See the section on User Management for details on how Robin RBAC works.
Tenant Administrators will only be able to share applications that are bound to their tenant.
Applications can only be shared with users who are members of the tenant the application is bound to.
Shares an application with a set of users within a tenant whilst also assigning the operations the aforementioned users are allowed to perform on the application.
End Point: /api/v3/robin_server/apps/<app_name>
Method: PUT
URL Parameters: None
Data Parameters:
action: share- This mandatory field within the payload specifies that the user share operation is to be performed.operation_list: <list_of_operations>- Utilizing this parameter within the payload, by specifying a comma seperated list of operations, results in the aforementioned users being able to perform the given operations on the target application. The ‘view’ operation is assigned by default regardless of which operations are given.user_list: <list_of_user_names>- Utilizing this parameter within the payload, by specifiying a comma seperated list of usernames, results in the application being shared with the respective users.all_tenant_users: true- Utilizing this parameter within the payload results in the application being shared with all users within the tenant the application is deployed in. The default value is false. Note this field overrides any users passed via theuser_listparameter.all_operations: true- Utilizing this parameter within the payload results in all valid operations being allowed for the given users on the application. The default value is false. Note this field overrides any operations passed via theoperation_listparameter.
Note
At least one of the following options, user_list or all_tenant_users, must be used in order to specify the users to share the application with. In addition at least one of the following options, operation_list or all_operations, must be given to specify the operations these users are allowed to perform on the application. To view a list of operations that can be unshared for the application, review the section detailed here.
Port: RCM Port (default value is 29442)
Headers:
Authorization: <auth_token>: Authorization token to identify which user is sending the request. The token can be acquired from the login API.
Success Response Code: 202
Error Response Code: 500 (Internal Server Error), 404 (Not Found Error), 401 (Unauthorized Error), 400 (Invalid API Usage Error)
Example Response:
Output
{
"plan":{
"current_user":{
"ip_addr":"172.20.0.1",
"user_permissions":{
},
"username":"robin",
"user_id":3,
"tenants":[
"t2",
"Administrators"
],
"session_expires":"2020-12-09T06:38:52",
"tenant":"Administrators",
"namespace":"t001-u000005",
"user_contexts":[
"robin",
"robin"
],
"tenant_id":1,
"user_context":"robin",
"user_capabilities":[
"AllSuperAdminCapabilities"
],
"tenant_role":"superadmin"
},
"name":"demo",
"namespace":"t001-u000005",
"kind":"robin",
"action":"share",
"user_list":[
"robin"
],
"all_tenant_users":false,
"operation_list":[
"view"
],
"opcode":null,
"all_operations":false
},
"jobid":667
}
10.15.2. Stop Sharing an Application¶
Run the following command to stop sharing an app with one or more users:
# robin app unshare name [user_list]
--operations <operations>
--all-tenant-users
|
Application instance name |
|
Optional comma separated list of users the application will no longer be shared with |
|
Comma separated list of operations the users will no longer be allowed to perform on the shared application. To prevent all all valid operations from being performed, specify ‘ALL_OPERATIONS’ on the command line. |
|
Stop sharing app with all tenant users for specified operations. Note this option is required when no users are explicitly specified |
Example:
# robin app unshare demo robin --wait
Job: 102 Name: ApplicationUnshare State: VALIDATED Error: 0
Job: 102 Name: ApplicationUnshare State: COMPLETED Error: 0
Note
The ability to stop sharing an application is subject to Robin Role Based Access Control (RBAC). By default, only Cluster and Tenant Administrators (users assigned the superadmin or tenantadmin role for the specified tenant) have permission to do so. See the section on User Management for details on how Robin RBAC works.
Tenant Administrators will only be able to stop sharing applications that are bound to their tenant.
Unshares an application with a set of users and/or unassigns operations the aforementioned users are allowed to perform on the application.
End Point: /api/v3/robin_server/apps/<app_name>
Method: PUT
URL Parameters: None
Data Parameters:
action: unshare- This mandatory field within the payload specifies that the user unshare operation is to be performed.operation_list: <list_of_operations>- Utilizing this parameter within the payload, by specifiying a comma seperated list of operations, results in the aforementioned users not being able to perform the given operations on the target application.user_list: <list_of_user_names>- Utilizing this parameter within the payload, by specifiying a comma seperated list of usernames, results in the application being unshared with the respective users.all_tenant_users: true- Utilizing this parameter within the payload results in the application being unshared with all users within the tenant the application is deployed in. The default value is false. Note this field overrides any users passed via theuser_listparameter.all_operations: true- Utilizing this parameter within the payload results in all valid operations being disallowed for the given application. The default value is false. Note this field overrides any operations passed via theoperation_listparameter.
Note
At least one of the following options, user_list or all_tenant_users, must be used in order to specify the users to share the application with. In addition at least one of the following options, operation_list or all_operations, must be given to specify the operations these users aren’t allowed to perform on the application. To view a list of operations that can be unshared for the application, review the section detailed here.
Port: RCM Port (default value is 29442)
Headers:
Authorization: <auth_token>: Authorization token to identify which user is sending the request. The token can be acquired from the login API.
Success Response Code: 202
Error Response Code: 500 (Internal Server Error), 404 (Not Found Error), 401 (Unauthorized Error), 400 (Invalid API Usage Error)
Example Response:
Output
{
"plan":{
"current_user":{
"ip_addr":"172.20.0.1",
"user_permissions":{
},
"username":"robin",
"user_id":3,
"tenants":[
"t2",
"Administrators"
],
"session_expires":"2020-12-09T06:38:52",
"tenant":"Administrators",
"namespace":"t001-u000005",
"user_contexts":[
"robin",
"robin"
],
"tenant_id":1,
"user_context":"robin",
"user_capabilities":[
"AllSuperAdminCapabilities"
],
"tenant_role":"superadmin"
},
"name":"demo",
"namespace":"t001-u000005",
"kind":"robin",
"action":"unshare",
"user_list":[
"robin"
],
"all_tenant_users":false,
"operation_list":[
"ALL_OPERATIONS"
],
"opcode":null,
"all_operations":true
},
"jobid":668
}
10.15.4. Reassign Ownership of an Application¶
Run the following command to reassign ownership of an app to a different tenant user:
# robin app change-owner <app_names> [username]
|
Comma separated list of one or more application names |
|
The username of the new owner. If a username is not provided then ownership of the app will be reassigned to the current user. |
Example:
# robin app change-owner demo user1
Job: 72 Name: ApplicationChangeOwner State: VALIDATED Error: 0
Job: 72 Name: ApplicationChangeOwner State: COMPLETED Error: 0
Note
The ability to reassign ownership of an app is subject to Robin Role Based Access Control (RBAC). By default, only Cluster and Tenant Administrators (users assigned the superadmin or tenantadmin role for the specified tenant) have permission to do so. See the section on User Management for details on how Robin RBAC works.
Tenant Administrators will only be able to reassign ownership of applications that are bound to their tenant.
Ownership of an app can only be reassigned to a user who is a member of the tenant the application is bound to.
Reassigns ownership of an application to a different tenant user.
End Point: /api/v3/robin_server/apps/<app_name>
Method: PUT
URL Parameters: None
Data Parameters:
action: change_owner- This mandatory field within the payload specifies that the change owner operation is to be performed.username: <username>- This mandatory field within the payload specifies the name of the user to whom the application’s ownership will be reassigned to.
Port: RCM Port (default value is 29442)
Headers:
Authorization: <auth_token>: Authorization token to identify which user is sending the request. The token can be acquired from the login API.
Success Response Code: 202
Error Response Code: 500 (Internal Server Error), 404 (Not Found Error), 401 (Unauthorized Error), 400 (Invalid API Usage Error)
Example Response:
Output
{
"plan":{
"opcode":null,
"current_user":{
"session_expires":"2020-09-18T17:25:02",
"user_id":3,
"tenant_role":"superadmin",
"user_contexts":[
"robin",
"robin"
],
"username":"robin",
"user_permissions":{
},
"tenant":"Administrators",
"user_context":"robin",
"user_capabilities":[
"AllSuperAdminCapabilities"
],
"ip_addr":"172.17.0.1",
"namespace":"t001-u000003",
"tenant_id":1,
"tenants":[
"t2",
"Administrators"
]
},
"username":"user1",
"namespace":"t001-u000003",
"kind":"robin",
"name":"demo",
"action":"change_owner",
"include_children":true
},
"jobid":73
}
10.16. Scaling services for a Robin Application¶
Robin Platform natively provides horizontal scaling of services for applications deployed via a Robin bundle. This allows your application to handle, with no additional downtime, increased loads and requests which could otherwise result in unresponsiveness. Moreover, if its utilization decreases, an application can also be scaled down according to demand. Issue the following command to scale an application horizontally:
# robin app scale <app_name> <role_name> <count>
--vnode-hostnames <hostnames>
--env <envs>
--ippools <ippools>
--tags <tags>
--cpu <cpu>
--gpu <gpu>
--mem <mem>
--storage <storage_config>
|
Application instance name |
|
Name of role to scale |
|
Number of instances to scale the role to |
|
Provide the hostnames on which the additional vnodes will be deployed |
|
Environment variables for additional vnodes |
|
IP Pool names and a comma seperated list of respective static IPs to allocate from them for each additional vnode e.g. <ippool_name>=<ip1>,<ip2> etc. |
|
Tags for additional vnodes |
|
CPU limits for additional vnodes |
|
GPU limits for additional vnodes |
|
Memory limits for additional vnodes |
|
Storage config for additional vnodes |
Example:
# robin app scale a1 server 3 --cpu 4 --wait
Job: 126 Name: ApplicationScale State: PROCESSED Error: 0
Job: 126 Name: ApplicationScale State: WAITING Error: 0
Job: 126 Name: ApplicationScale State: COMPLETED Error: 0
10.17. Scaling resources for a Robin Application¶
Robin Platform natively provides vertical scaling of services for applications deployed via a Robin bundle. This allows your application to use a greater amount of resources (cpu, memory etc.) which would allow it to function at a greater capacity. It also enables better resource management post-creation of an application. This includes reducing the number of resources consumed by the application. Issue the following command to scale an application vertically:
Note
Only Vnodes which are in the states: ONLINE or PLAN_FAILED, will be scaled up.
# robin app computeqos <app_name>
--role <role>
--cpus <cpu>
--gpus <gpu>
--memory <mem>
--hugepages-2mi <hgps_2m>
--hugepages-1gi <hgps_1g>
--swap <swap>
|
Application instance name |
|
Name of role to scale |
|
Maximum number of CPUs per instance |
|
Maximum number of GPUs per instance |
|
Memory limit per instance in bytes |
|
2Mi Hugepages limit per instance in bytes |
|
1Gi Hugepages limit per instance in bytes |
|
Swap limit per instance in bytes |
Example:
# robin app computeqos a1 --role server --cpus 3 --wait
Job: 128 Name: ApplicationComputeQos State: PROCESSED Error: 0
Job: 128 Name: ApplicationComputeQos State: WAITING Error: 0
Job: 128 Name: ApplicationComputeQos State: COMPLETED Error: 0
10.18. Storage QoS for a Robin Application¶
Robin Platform natively allows a user to manage the storage performance of their application. As a result, a user can set min/max write and read I/O performance for their application which in turn helps reduce I/O bottlenecks depending on the nature of the application. Issue the following command to scale the Storage I/OPs of an application:
# robin app storageqos <app_name>
--role <role>
--volume-type <vol_type>
--read-min-iops <read_min>
--read-max-iops <read_max>
--read-weight <read_weight>
--write-min-iops <write_min>
--write-max-iops <write_max>
--write-weight <write_weight>
|
Application instance name |
|
Name of role to scale storage I/OPs for |
|
Type of volume to scale storage I/OPs for |
|
Minimum I/OPs for read operations |
|
Maximum I/OPs for read operations |
|
Relative weightage for read operations. Only values between 1 and 6 can be specified |
|
Minimum I/OPs for write operations |
|
Maximum I/OPs for write operations |
|
Relative weightage for write operations. Only values between 1 and 6 can be specified |
Example:
# robin app storageqos demo --role server --volume-type data --read-min-iops 1000 --wait
Job: 185 Name: ApplicationStorageQos State: VALIDATED Error: 0
Job: 185 Name: ApplicationStorageQos State: COMPLETED Error: 0
Set min/max write and read I/O performance for an application.
End Point: /api/v3/robin_server/apps/<app_name>
Method: PUT
URL Parameters: None
Data Parameters:
action: storageqos- This mandatory field within the payload specifies that the storage QoS operation is to be performed.role: <role>- This mandatory field within the payload specifies the name of the application’s role whose volume parameters will be modified.vol_type: <vol_type>- This mandatory field within the payload specifies the volume type of the aforementioned role for which I/O parameters will be modified.qos_cfg: <dict_of_qos_params>–rd_min_iops: <rd_min_iops>- Utilizing this parameter within the dictionary, by specifying an integer, results in the minimum I/OPs for read operations being set to the given value.rd_max_iops: <rd_max_iops>- Utilizing this parameter within the dictionary, by specifying an integer, results in the maximum I/OPs for read operations being set to the given value.rd_weight: <rd_weight>- Utilizing this parameter within the dictionary, by specifying an integer between 1 and 6, results in the relative weightage for read operations being set to the given value.wr_min_iops: <wr_min_iops>- Utilizing this parameter within the dictionary, by specifying an integer, results in the minimum I/OPs for write operations being set to the given value.wr_max_iops: <wr_max_iops>- Utilizing this parameter within the dictionary, by specifying an integer, results in the maximum I/OPs for write operations being set to the given value.wr_weight: <wr_weight>- Utilizing this parameter within the dictionary, by specifying an integer between 1 and 6, results in the relative weightage for write operations being set to the given value.
Port: RCM Port (default value is 29442)
Headers:
Authorization: <auth_token>: Authorization token to identify which user is sending the request. The token can be acquired from the login API.
Success Response Code: 202
Error Response Code: 500 (Internal Server Error), 404 (Not Found Error), 401 (Unauthorized Error), 400 (Invalid API Usage Error)
Example Response:
Output
{
"jobid":263,
"plan":{
"action":"storageqos",
"role":"server",
"vol_type":"data",
"qos_cfg":{
"rd_min_iops":1100
},
"name":"test1",
"namespace":"t001-u000003",
"kind":"robin",
"opcode":null,
"current_user":{
"user_id":3,
"username":"robin",
"tenant_id":1,
"tenant":"Administrators",
"tenants":[
"Administrators"
],
"tenant_role":"superadmin",
"namespace":"t001-u000003",
"user_context":"robin",
"user_contexts":[
"robin"
],
"user_capabilities":[
"AllSuperAdminCapabilities"
],
"user_permissions":{
},
},
"appdata":{
"name":"test1",
"version":"7",
"snapshot":"enabled",
"clone":"enabled",
"roles":[
{
"name":"server",
"multinode":true,
"image":{
"name":"robinsys\/centos",
"version":"7",
"engine":"docker",
"entrypoint":"entry.sh",
"init_mode":false,
"registry_hostname":"",
"registry_port":""
},
"display_name":"server",
"vnodes":[
{
"name":"test1.server.01",
"multinode":true,
"storage":[
{
"type":"data",
"media":"HDD",
"path":"\/data",
"size":1073741824,
"blocksize":4096,
"compression":"disabled",
"layout":"round-robin",
"name":"test1.server.01.data.1.057388c3-5410-4152-8b8b-4210165cc384",
"protection":0,
"replication":1,
"faultdomain":"host",
"encryption":"none",
"disk_tags":{
},
"lvm_type":"None",
"lvm_vol_count":"0",
"workload":0,
"snap_reserved":20,
"snapshot_space_limit":214748365,
"fstype":"ext4",
"stordriver":{
"media":"HDD",
"protection":0,
"faultdomain":"host",
"type":"das"
},
"pvcpolicy":"create",
"k8s_name":"test1-server-01-data-1-057388c3",
"vol_ns":"t001-u000003",
"volgrp_name":"test1.server.01.72.1.d02321dd-0c18-4e47-9e74-0467a0c3517d",
"allocated":{
"size":1073741824,
"grpid":4,
"multinode_mounting":false,
"qgroupid":4,
"appid":1,
"name":"test1.server.01.data.1.057388c3-5410-4152-8b8b-4210165cc384",
"snapshot_space_limit":214748365,
"current_snapshotid":1,
"vtype":0,
"slice_size":1073741824,
"replication":1,
"media":72,
"volumeid":"5",
"protection":0,
"priority":2,
"next_backupid":1,
"compression":0,
"resource_poolid":1,
"partitions":0,
"block_size":4096,
"appname":"default",
"params":{
},
"current_snapshot":"active_snap",
"next_snapshotid":2,
"genkey":1611119983972436,
"stordriver":{
"media":"HDD",
"protection":0,
"faultdomain":"host",
"type":"das"
}
}
},
{
"type":"block",
"media":"HDD",
"path":"\/dev\/rda",
"size":1073741824,
"fstype":"raw",
"blocksize":4096,
"compression":"disabled",
"layout":"round-robin",
"name":"test1.server.01.block.1.52b19e79-34a6-4797-86a7-724ceae401d2",
"protection":0,
"replication":1,
"faultdomain":"host",
"encryption":"none",
"disk_tags":{
},
"lvm_type":"None",
"lvm_vol_count":"0",
"workload":0,
"snap_reserved":20,
"snapshot_space_limit":214748365,
"stordriver":{
"media":"HDD",
"protection":0,
"faultdomain":"host",
"type":"das"
},
"pvcpolicy":"create",
"k8s_name":"test1-server-01-block-1-52b19e79",
"vol_ns":"t001-u000003",
"volgrp_name":"test1.server.01.72.1.76fc29b1-a0de-42eb-bede-21e5d1250a4a",
"allocated":{
"size":1073741824,
"grpid":5,
"multinode_mounting":false,
"qgroupid":5,
"appid":1,
"name":"test1.server.01.block.1.52b19e79-34a6-4797-86a7-724ceae401d2",
"snapshot_space_limit":214748365,
"current_snapshotid":1,
"vtype":0,
"slice_size":1073741824,
"replication":1,
"media":72,
"volumeid":"4",
"protection":0,
"priority":2,
"next_backupid":1,
"compression":0,
"resource_poolid":1,
"partitions":0,
"block_size":4096,
"appname":"default",
"params":{
},
"current_snapshot":"active_snap",
"next_snapshotid":2,
"genkey":1611119983965589,
"stordriver":{
"media":"HDD",
"protection":0,
"faultdomain":"host",
"type":"das"
}
}
}
],
"vnodehooks":{
"postcreate":"bash postcreate.sh"
},
"cpu":{
"reserve":false,
"min":0,
"max":1
},
"gpu":{
"min":0,
"max":0
},
"mem":{
"size":209715200,
"hugepages_2m":0,
"hugepages_1g":0
},
"env":{
"ENABLE_SSH":{
"type":"boolean",
"value":true
},
"DOCKER_OPTS":{
"type":"text",
"value":"-v \/sys\/fs\/cgroup:\/sys\/fs\/cgroup --cap-add=SYS_ADMIN"
},
"ROOT_PASSWORD":{
"type":"password",
"value":""
},
"allocated":{
"ENABLE_SSH":true,
"DOCKER_OPTS":"-v \/sys\/fs\/cgroup:\/sys\/fs\/cgroup --cap-add=SYS_ADMIN",
"ROOT_PASSWORD":"",
"ROBINHOST":"vnode-95-76.robinsystems.com",
"K8S_NODE":"vnode-95-76.robinsystems.com",
"POD_NAME":"test1-server-01",
"POD_NS":"t001-u000003",
"ROBINHOST_TAG_KUBERNETES.IO-OS":"linux",
"ROBINHOST_TAG_KUBERNETES.IO-ARCH":"amd64",
"ROBINHOST_TAG_ROBINRPOOL":"default"
}
},
"network":[
{
"ippool":"robin-default",
"name":"robin-default",
"driver":"calico",
"interfaces":1,
"allocated_ip":"172.21.29.53",
"allocated_netmask":"255.255.0.0",
"allocated_prefix":16,
"subnet":"172.21.0.0",
"allocated_by":"system",
"allocated_names":[
"eth0"
]
}
],
"enable_portmapping":true,
"enable_hooklogs":true,
"enable_metrics":true,
"sidecar_info":{
"cpu":0,
"mem":0,
"gpu":0,
"hugepages_2m":0,
"hugepages_1g":0,
"containers":[
]
},
"role_name":"server",
"rpoolid":1,
"calico_inuse":true,
"restart_on_qoscfg":true,
"allocated":{
"zoneid":1608100028,
"zonename":"default",
"nodeid":1,
"nodename":"vnode-95-76"
},
"allocated_host":"vnode-95-76.robinsystems.com",
"k8s_provider":"robin",
"allocated_host_type":"physical",
"numa_allocations":{
"0":{
"non_isol_cores_used":1,
"isol_shared_cores_used":0,
"isol_dedicated_cores_used":0,
"mem_used":209715200,
"hugepages_1g_used":0,
"hugepages_2m_used":0,
"gpu_used":0
}
},
"allocated_host_public_hostname":"vnode-95-76.robinsystems.com",
"allocated_host_public_ip":"10.9.95.76",
"hosttags":{
"kubernetes.io\/os":[
"linux"
],
"kubernetes.io\/arch":[
"amd64"
],
"robin.io\/robinrpool":[
"default"
]
},
"volume_groups":[
{
"media":"HDD",
"rpoolid":1,
"volumes":[
"test1.server.01.data.1.057388c3-5410-4152-8b8b-4210165cc384"
],
"layout":"round-robin",
"device_sets":[
{
"devices":[
{
"wwn":"0xQEMU_QEMU_HARDDISK_b77676df-21a6-40e1-9",
"capacity":53687091200,
"type":"HDD",
"state":"READY",
"reattachable":0,
"protected":0,
"role":"Storage",
"devpath":"\/dev\/disk\/by-id\/scsi-0QEMU_QEMU_HARDDISK_b77676df-21a6-40e1-9",
"host":"vnode-95-76.robinsystems.com",
"tags":{
},
"max_volumes_per_disk":10,
"max_latency_sensitive_vols_per_disk":2,
"max_throughput_intensive_vols_per_disk":1,
"pused":0,
"psize":53687091200,
"slices":38,
"aslices":0,
"write_unit":512,
"stormgr_id":1,
"hostname":"vnode-95-76.robinsystems.com",
"score":100,
"allocated_slices":2
}
],
"name":"test1.server.01.72.1.d02321dd-0c18-4e47-9e74-0467a0c3517d.0.5ef90f50-3ac8-4b14-8164-0f56439118e5",
"stormgr_id":4
}
],
"replicas":1,
"name":"test1.server.01.72.1.d02321dd-0c18-4e47-9e74-0467a0c3517d",
"stormgr_id":4
},
{
"media":"HDD",
"rpoolid":1,
"volumes":[
"test1.server.01.block.1.52b19e79-34a6-4797-86a7-724ceae401d2"
],
"layout":"round-robin",
"device_sets":[
{
"devices":[
{
"wwn":"0xQEMU_QEMU_HARDDISK_b77676df-21a6-40e1-9",
"capacity":53687091200,
"type":"HDD",
"state":"READY",
"reattachable":0,
"protected":0,
"role":"Storage",
"devpath":"\/dev\/disk\/by-id\/scsi-0QEMU_QEMU_HARDDISK_b77676df-21a6-40e1-9",
"host":"vnode-95-76.robinsystems.com",
"tags":{
},
"max_volumes_per_disk":10,
"max_latency_sensitive_vols_per_disk":2,
"max_throughput_intensive_vols_per_disk":1,
"pused":0,
"psize":53687091200,
"slices":38,
"aslices":0,
"write_unit":512,
"stormgr_id":1,
"hostname":"vnode-95-76.robinsystems.com",
"score":100,
"allocated_slices":2
}
],
"name":"test1.server.01.72.1.76fc29b1-a0de-42eb-bede-21e5d1250a4a.0.629def65-6cae-4395-af9f-a126a7b193cb",
"stormgr_id":5
}
],
"replicas":1,
"name":"test1.server.01.72.1.76fc29b1-a0de-42eb-bede-21e5d1250a4a",
"stormgr_id":5
}
],
"pod_name":"test1-server-01",
"pod_ns":"t001-u000003",
"hostname":"test1-server-01.t001-u000003.svc.cluster.local",
"host_ip":"172.21.29.53",
"service_uids":[
],
"vnodehookargs":{
"postcreate":[
]
},
"id":1,
"restart_num":15,
"role":"server",
"appname":"test1",
"appid":2,
"state":"STARTED",
"root_fs":"\/usr\/local\/robin\/instances\/test1-server-01.t001-u000003.svc.cluster.local",
"bundle_path":"\/usr\/local\/robin\/collections\/file-collection-1608100413051\/1611119928411\/centos-7",
"bundle_object_id":"303fa86aab3ed746b67232b00e86025f",
"bundleid":2,
"engine":"docker",
"image":{
"name":"robinsys\/centos",
"version":"7",
"engine":"docker",
"entrypoint":"entry.sh",
"init_mode":false,
"registry_hostname":"",
"registry_port":""
},
"cm_keys":[
"ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQCmMKD4kq7GasuAlIN4OiJ3svBr3ogCDmHiKcC53MwDcbW6BDm2i8pIV1i5MDqcjqoygDdcjIEFqfjdRVqV\/bcGid1sxdTStkdHazQlPFbQ4bYRelySNcWnfn6yeXVfO\/b3E8Bm\/3iYeryEn4A7CyKVdy7jGuRBl2F6c0UqYsMoVMioSrI+obT6crDF85bOTsnunjtqAm9Toz5zACOng2qhSKkrSTNer5uRQ2XfyadEHXlNrgZl2hxolTGrDrGEaUo\/MQC1oO0JkPYsw+XQdx\/JDSKOxeCtuwXOJj\/omlScmjogC9Vei1TzSLKEtSqjv6UCXzKBmyczPBUgnUivG+NV root@vnode-95-76.robinsystems.com"
],
"ctime":1611120032,
"utime":1611120032,
"vnodeid":1
}
],
"qgroups":{
"data":{
"enabled":false,
"priority":1,
"rd_max_iops":2000000,
"rd_min_iops":1000,
"rd_min_window":500,
"rd_weight":1,
"wr_max_iops":2000000,
"wr_min_iops":0,
"wr_min_window":500,
"wr_weight":1
},
"block":{
"enabled":false,
"priority":1,
"rd_max_iops":2000000,
"rd_min_iops":0,
"rd_min_window":500,
"rd_weight":1,
"wr_max_iops":2000000,
"wr_min_iops":0,
"wr_min_window":500,
"wr_weight":1
}
},
"restart_on_qoscfg":true,
"volume_groups":[
]
}
],
"robin_version":"5.3.4-1127",
"pvcpolicy":"create",
"rpool":"default",
"from_template":null,
"zoneid":1608100028,
"bundleid":2,
"content_id":"303fa86aab3ed746b67232b00e86025f",
"namespace":"t001-u000003",
"restart_num":15,
"auto_relocate":true,
"rpoolid":1,
"username":"robin",
"tenant":"Administrators",
"app_ns":"t001-u000003",
"enable_hooklogs":true,
"enable_metrics":true,
"planid":1,
"id":2,
"bundle_path":"\/usr\/local\/robin\/collections\/file-collection-1608100413051\/1611119928411\/centos-7",
"bundle_object_id":"303fa86aab3ed746b67232b00e86025f"
}
}
}
10.19. Upgrading a Robin Application¶
Robin Platform provides a native and seamless upgrade workflow for applications deployed via Robin bundles. When a new version of an application bundle is added to a Robin Platform custer, all eligible applications are made available for upgrades. One can proceed with the upgrade of an application in a variety of manners with only minimal downtime for the application. These are the supported upgrade options:
Standard upgrade - all services are upgraded at the same time by restarting pods with the new images and/or hook scripts.
Online upgrade - If the PODs and services are upgraded outside of ROBIN, this mode can be used to upgrade the application to the latest bundle specified for future restarts/redeploys. This option is used when performing an RPM level upgrade inside KVM virtual machine PODs.
Rolling upgrade - the services of an application are updated incrementally with zero to minimal downtime.
Image upgrade(s) - images used for specific (or all) containers across multiple services can be updated to newer versions. This option can be used in combination with the others and will also create a new bundle with a manifest containing the new image names and/or versions.
A dry run of the upgrade can be performed on a clone of the specified application. This allows the user to verify the upgrade works as expected.
In all situations a snapshot of the specified application is taken to ensure if that there are any issues with the upgrade, one can always rollback the application to a healthy state. The snapshot acts as a fail-safe to ensure that an application is always recoverable regardless of what happens with the upgrade. There is an option to disable this feature, but normally this is not recommended.
Note
The upgrade path specifying the version dependencies is defined within the bundle manifest. For more details, review the bundle building guide here.
# robin app upgrade <app_name>
--bundleid <bundle_id>
--image <image_str>
--test
--rolling
--online
--skip-snap
|
Application instance name |
|
ID of bundle to upgrade to |
|
Images to be updated to eg, ‘r1=i1:v1,r1.s1=i2:v2’ where r1 refers to the role, s1 refers to the sidecar container name, i1,i2 refer to the image names and v1,v2 refer to the image versions |
|
Test the upgrade using a clone of the app |
|
Perform a rolling upgrade |
|
Skip taking a snapshot before the upgrade process |
|
Skip restarting the application PODs as part of the upgrade process |
Note
Either one of the following options must be specified: --bundleid or --image
Example 1 (Rolling upgrade for an application):
# robin app upgrade a4 --bundleid 4 --rolling --wait
Upgrading application a4...Done
Example 2 (Online upgrade for an application without a snapshot):
# robin app upgrade kvm1 --bundleid 4 --online --skip-snap --wait
Upgrading application kvm1...Done
Upgrades an application from the current bundle and image to a newly specified bundle and image.
End Point: /api/v3/robin_server/apps/<app_name>
Method: PUT
URL Parameters: None
Data Parameters:
action: upgrade- This mandatory field within the payload specifies that the upgrade operation is to be performed.bundleid: <bundleid>- Utilizing this parameter within the payload by specifying an integer representing a bundle ID results in the application being upgraded to the associated bundle.image: <image_str>- Utilizing this parameter within the payload by specifying a string in the format ‘r1=i1:v1,r1.s1=i2:v2’ where r1 refers to the role, s1 refers to the sidecar container name, i1,i2 refer to the image names and v1,v2 refer to the image versions results in the container/sidecar images being upgraded to those specified.test: true- Utilizing this parameter within the payload results in a test upgrade being performed on a clone of the application. The default value is False.rolling: true- Utilizing this parameter within the payload results in the upgrade operation to be performed is a rolling upgrade. The default value is False.take_snap: false- Utilizing this parameter within the payload determines whether or not a snapshot is taken before an application is upgrade. The default value is True.online: true- Utilizing this parameter within the payload results in the application PODs not being restarted as part of the upgrade process. The default value is False.
Note
Either one of the following parameters must be specified within the payload: bundleid or image
Port: RCM Port (default value is 29442)
Headers:
Authorization: <auth_token>: Authorization token to identify which user is sending the request. The token can be acquired from the login API.
Success Response Code: 202
Error Response Code: 500 (Internal Server Error), 404 (Not Found Error), 401 (Unauthorized Error), 400 (Invalid API Usage Error)
Example Response:
Output
{
"plan":{
"name":"demo",
"current_user":{
"ip_addr":"172.20.0.1",
"user_permissions":{
},
"username":"robin",
"user_id":3,
"tenants":[
"t2",
"Administrators"
],
"session_expires":"2020-12-08T05:11:45",
"tenant":"Administrators",
"namespace":"t001-u000003",
"user_contexts":[
"robin",
"robin"
],
"tenant_id":1,
"user_context":"robin",
"user_capabilities":[
"AllSuperAdminCapabilities"
],
"tenant_role":"superadmin"
},
"bundleid":7,
"rolling":false,
"action":"upgrade",
"kind":"robin",
"authorization_token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyX2lkIjozLCJ0ZW5hbnRfaWQiOjEsImV4cCI6MTYwNzQwNDMwNX0.Lawioo1JaQMV99xdPS7c6UcGfveocO00tRZ2qBO6ik8",
"namespace":"random",
"opcode":null,
"test":false
},
"jobid":652
}
10.20. Attach an External Storage Repo to an Application¶
Robin Platform allows entire applications, plus their data to be backed up to an external storage device or service such as AWS S3, Google GCS object stores, etc. Repo management is explained at length here. Issue the following command to attach a repo to an application:
# robin app attach-repo <app_name> <repo_name>
|
Application instance name |
|
Name of the storage repo |
Example:
# robin app attach-repo mysql-c1 testrepo --wait
Job: 115 Name: ApplicationAddRepo State: VALIDATED Error: 0
Job: 115 Name: ApplicationAddRepo State: COMPLETED Error: 0
Attaches a repo to an application in order to enable backups for it.
End Point: /api/v3/robin_server/apps/<appname>
Method: PUT
URL Parameters: None
Data Parameters:
action: add_repo- This mandatory field within the payload specifies that the repo attach operation is to be performed.repo_name: <repo_name>- This mandatory field within the payload specifies the repo to be attached to the application.name: <appname>- This mandatory field within the payload specifies the application to which the aforementioned repo should be attached.
Port: RCM Port (default value is 29442)
Headers:
Authorization: <auth_token>: Authorization token to identify which user is sending the request. The token can be acquired from the login API.
Success Response Code: 202
Error Response Code: 500 (Internal Server Error), 404 (Not Found Error), 401 (Unauthorized Error), 400 (Invalid API Usage Error)
Example Response:
Output
{
"plan":{
"action":"add_repo",
"name":"mysql-jf6s",
"current_user":{
"user_context":"robin",
"tenants":[
"Administrators"
],
"namespace":"t001-u000003",
"session_expires":"2020-09-09T00:09:42",
"tenant_role":"superadmin",
"tenant":"Administrators",
"user_permissions":{
},
"user_contexts":[
"robin",
"robin-k8s-cluster"
],
"user_capabilities":[
"AllSuperAdminCapabilities"
],
"ip_addr":"172.17.0.1",
"user_id":3,
"tenant_id":1,
"username":"robin"
},
"namespace":"t001-u000003",
"opcode":null,
"kind":"robin",
"repo_name":"app-repompsq"
},
"jobid":725
}
10.21. Detach an External Storage Repo from an Application¶
A previously attached storage repo can be detached from an Application using this command:
# robin app detach-repo <app_name> <repo_name>
--purge-in-repo
--yes
|
Application instance name |
|
Name of the storage repo |
|
Delete all backup copies in repo associated from this cluster |
|
Do not prompt the user for confirmation |
Example:
# robin app detach-repo mysql-c1 testrepo --wait
Job: 116 Name: ApplicationRemoveRepo State: PREPARED Error: 0
Job: 116 Name: ApplicationRemoveRepo State: COMPLETED Error: 0
Detaches a previously attached repo from an application.
End Point: /api/v3/robin_server/apps/<appname>
Method: PUT
URL Parameters: None
Data Parameters:
action: remove_repo- This mandatory field within the payload specifies that the repo detach operation is to be performed.repo_name: <repo_name>- This mandatory field within the payload specifies the repo to be detached from the application.name: <appname>- This mandatory field within the payload specifies the application from which the aforementioned repo should be detached.purge: true- Utilizing this parameter results in all backups associated with this cluster within the specified repo being deleted.
Port: RCM Port (default value is 29442)
Headers:
Authorization: <auth_token>: Authorization token to identify which user is sending the request. The token can be acquired from the login API.
Success Response Code: 202
Error Response Code: 500 (Internal Server Error), 404 (Not Found Error), 401 (Unauthorized Error), 400 (Invalid API Usage Error)
Example Response:
Output
{
"plan":{
"purge":false,
"namespace":"t001-u000003",
"current_user":{
"user_context":"robin",
"tenants":[
"Administrators"
],
"namespace":"t001-u000003",
"session_expires":"2020-09-09T00:09:42",
"tenant_role":"superadmin",
"tenant":"Administrators",
"user_permissions":{
},
"user_contexts":[
"robin",
"robin-k8s-cluster"
],
"user_capabilities":[
"AllSuperAdminCapabilities"
],
"ip_addr":"172.17.0.1",
"user_id":3,
"tenant_id":1,
"username":"robin"
},
"action":"remove_repo",
"name":"mysql-jf6s",
"kind":"robin",
"opcode":null,
"repo_name":"app-repompsq"
},
"jobid":730
}
10.22. Manage Application Snapshot Schedules¶
Robin Platform allows configuring a schedule to automatically snapshot applications and set retention policies. The advantage is that an application can always be rolled back to a point in time when it was healthy. The schedule can be set via a JSON file or a CRON string. Issue the following command to set up a snapshot schedule for an app:
# robin app snapshot-schedule <app_name>
--snapshot-schedule <schedule>
--snapshot-schedule-cron <schedule>
--retain <retained_snapshots>
--disable
--enable
|
Application instance name |
|
Snapshot schedule specified as JSON |
|
Snapshot schedule specified as CRON string |
|
Number of snapshots to retain with the specified schedule |
|
Disable the specified schedule |
|
Enable the specified schedule |
The fields that can be specified in the JSON file describing a schedule are:
|
The overall frequency at which to take snapshots. Valid values include: ‘hourly’, ‘daily’, ‘weekly’, ‘monthly’. |
|
An integer between 1-59 representing the minute at which the operation should be run. This field is optional, and the default value is 1 if not specified. |
|
An integer between 0-23 representing the hour at which the operation should be run. This field is optional, and the default value is 0 if not specified. |
|
An integer between 0-6 representing the day of the week on which the operation should be run. Sunday is represented by 0 and so on and so forth. This field is optional, and the default value is 0 if not specified. |
|
An integer between 1-28 representing the day of the month on which the operation should be run. This field is optional, and the default value is 1 if not specified. |
Note
Only one snapshot schedule of each frequency type can be created. You cannot set 2 different hourly snapshot schedules. However, 1 hourly and 1 weekly schedule is a supported combination.
Snapshot Schedule as a JSON:
Here’s an example of a JSON file describing a snapshot schedule:
{
"frequency": "weekly",
"weekday": 3,
"hour": 5,
"minute": 30,
}
The above JSON will configure a snapshot schedule running every week on Wednesday at 05:30 AM.
# robin app snapshot-schedule a1 --snapshot-schedule demo_sched.json --retain 2 --enable --wait
Job: 116 Name: ApplicationSetSnapBack State: PREPARED Error: 0
Job: 116 Name: ApplicationSetSnapBack State: COMPLETED Error: 0
Snapshot Schedule as a CRON:
Robin allows one to specify a snapshot schedule via a CRON string with the standardised format. However there are three caveats. First the minute parameter of the string must always be set as minutely snapshot schedules are not supported. In a similar vein the parameter indicating the month must also be set (if applicable) as yearly schedules are not supported either. Finally one cannot specify both a day of the month and a day of the week as it is not a support configuration.
Here’s an example of a CRON string describing a snapshot schedule:
30 5 * * 3
The above CRON string configures a snapshot schedule running every week on Wednesday at 05:30 AM.
# robin app snapshot-schedule a1 --snapshot-schedule-cron "30 5 * * 3" --retain 2 --enable --wait
Job: 116 Name: ApplicationSetSnapBack State: PREPARED Error: 0
Job: 116 Name: ApplicationSetSnapBack State: COMPLETED Error: 0
10.23. Manage Application Backup Schedules¶
Robin Platform allows configuring a schedule to automatically backup application snapshots and set retention policies. The advantage is that an application can always be restored to the state saved in the backup. The schedule can be set via a JSON file or a CRON string. Issue the following command to set up a backup schedule for an app:
Note
A snapshot schedule must be configured for the application before a backup schedule can be set.
# robin app backup-schedule <app_name>
--backup-schedule <schedule>
--backup-schedule-cron <schedule>
--retain <retained_backups>
--filter <snap_filter>
--disable
--enable
|
Application instance name |
|
Backup schedule specified as JSON |
|
Backup schedule specified as CRON string |
|
Number of backups to retain with the specified schedule |
|
Frequency of snapshot schedule to backup |
|
Disable the specified schedule |
|
Enable the specified schedule |
The fields that can be specified in the JSON file describing a schedule are:
|
The overall frequency at which to take backups. Valid values include: ‘hourly’, ‘daily’, ‘weekly’, ‘monthly’. |
|
An integer between 1-59 representing the minute at which the operation should be run. This field is optional, and the default value is 1 if not specified. |
|
An integer between 0-23 representing the hour at which the operation should be run. This field is optional, and the default value is 0 if not specified. |
|
An integer between 0-6 representing the day of the week on which the operation should be run. Sunday is represented by 0 and so on and so forth. This field is optional, and the default value is 0 if not specified. |
|
An integer between 1-28 representing the day of the month on which the operation should be run. This field is optional, and the default value is 1 if not specified. |
Note
Only one backup schedule of each frequency type can be created. You cannot set 2 different hourly backup schedules. However, 1 hourly and 1 weekly schedule is a supported combination.
Backup Schedule as a JSON:
Here’s an example of a JSON file describing a backup schedule:
{
"frequency": "weekly",
"weekday": 0,
"hour": 7,
"minute": 15,
}
The above JSON will configure a backup schedule running every week on Sunday at 07:15 AM.
# robin app backup-schedule a1 --backup-schedule demo_sched.json --retain 3 --enable --filter daily --wait
Job: 116 Name: ApplicationSetSnapBack State: PREPARED Error: 0
Job: 116 Name: ApplicationSetSnapBack State: COMPLETED Error: 0
Backup Schedule as a CRON:
Robin allows one to specify a backup schedule via a CRON string with the standardised format. However there are three caveats. First the minute parameter of the string must always be set as minutely backup schedules are not supported. In a similar vein the parameter indicating the month must also be set (if applicable) as yearly schedules are not supported either. Finally one cannot specify both a day of the month and a day of the week as it is not a support configuration.
Here’s an example of a CRON string describing a snapshot schedule:
15 7 * * 0
The above CRON string will configure a backup schedule running every week on Sunday at 07:15 AM.
# robin app backup-schedule a1 --backup-schedule-cron "15 7 * * 0" --retain 2 --enable --filter daily --wait
Job: 116 Name: ApplicationSetSnapBack State: PREPARED Error: 0
Job: 116 Name: ApplicationSetSnapBack State: COMPLETED Error: 0
10.24. Restore an Application from a Snapshot or Backup¶
An application can be restored to the point-in-time state saved within an associated snapshot or backup (a snapshot that has been pushed to a storage repo). Issue the following command to recover an app to a specific point-in-time:
# robin app restore <app_name> [--snapshotid <snapshotid>] [--backupid <backupid>]
|
Application instance name |
|
ID of application snapshot |
|
ID of application backup |
Note
One of --snapshotid or --backkupid must be provided.
Example:
# robin app restore mysql1 --snapshotid 2b388be6497211eaba7a190f2cdd554f --wait
Job: 188 Name: K8SApplicationRollback State: PREPARED Error: 0
Job: 188 Name: K8SApplicationRollback State: AGENT_WAIT Error: 0
Job: 188 Name: K8SApplicationRollback State: COMPLETED Error: 0
Restores an application to the point-in-time state saved within an associated snapshot or backup (a snapshot that has been pushed to a storage repo).
End Point: /api/v3/robin_server/robin_server/apps/<appname>
Method: PUT
URL Parameters: None
Data Parameters:
action: rollback- This mandatory field within the payload specifies that the restore operation is to be performed.snapshotid: <snapshotid>- Utilizing this parameter, by specifiying the UUID of a snapshot, results in the application being rolled back to the state saved in the aformentioned snapshot.backupid: <backupid>- Utilizing this parameter, by specifiying the UUID of a backup, results in the application being rolled back to the state saved in the aformentioned backup.
Note
One of snapshotid or backupid must be provided.
Port: RCM Port (default value is 29442)
Headers:
Authorization: <auth_token>: Authorization token to identify which user is sending the request. The token can be acquired from the login API.
Success Response Code: 202
Error Response Code: 500 (Internal Server Error), 404 (Not Found Error), 401 (Unauthorized Error), 400 (Invalid API Usage Error)
Example Response:
Output
{
"plan":{
"snap_app":{
"roles":[
{
"vnodes":[
{
"service_uids":[
"390f55e2-56dd-46f1-8c94-4f0c38c92aeb"
],
"rpoolid":1,
"network":[
{
"subnet":"172.21.0.0",
"ippool":"robin-default",
"interfaces":1,
"allocated_ip":"172.21.24.104",
"allocated_prefix":16,
"name":"robin-default",
"allocated_by":"system",
"driver":"calico",
"allocated_names":[
"eth0"
],
"allocated_netmask":"255.255.0.0"
}
],
"sidecar_info":{
"mem":0,
"gpu":0,
"hugepages_2m":0,
"containers":[
],
"cpu":0,
"hugepages_1g":0
},
"hosttags":{
"robinhost":[
"cscale-82-239"
],
"kubernetes.io\/arch":[
"amd64"
],
"rnodetype":[
"robin-worker-node"
],
"nodetype":[
"robin-node"
],
"domain":[
"ROBIN"
],
"kubernetes.io\/os":[
"linux"
],
"robin.io\/robinrpool":[
"default"
],
"robinrpool":[
"default"
]
},
"enable_hooklogs":true,
"cmdlineargs":"-W",
"vnodehooks":{
"prestart":"bash vnode_sample opr=prestart",
"postcreate":"bash check_mysql",
"poststart":"bash check_mysql",
"postgrow":"bash check_mysql",
"postrollback":"bash check_mysql",
"poststop":"bash vnode_sample opr=poststop",
"pregrow":"bash vnode_sample opr=pregrow",
"prerollback":"bash vnode_sample opr=prerollback",
"preclone":"bash vnode_sample opr=preclone",
"prestop":"bash vnode_sample opr=prestop",
"precreate":"bash vnode_sample opr=precreate",
"postsnapshot":"bash unquiesce.sh",
"presnapshot":"bash quiesce.sh",
"postclone":"bash check_mysql",
"postdestroy":"bash vnode_sample opr=postdestroy",
"predestroy":"bash vnode_sample opr=predestroy"
},
"hostname":"lak-mysql-01.t001-u000003.svc.cluster.local",
"bundle_object_id":"7be85809d7ecf1544e461df868f163ad",
"enable_portmapping":true,
"image":{
"entrypoint":"custom-entrypoint.sh",
"engine":"docker",
"version":"5.7",
"registry_hostname":"",
"name":"mysql",
"registry_port":""
},
"numa_allocations":{
"0":{
"gpu_used":0,
"isol_dedicated_cores_used":0,
"hugepages_1g_used":0,
"non_isol_cores_used":1,
"isol_shared_cores_used":0,
"hugepages_2m_used":0,
"mem_used":1073741824
}
},
"calico_inuse":true,
"allocated_host_public_hostname":"cscale-82-239.robinsystems.com",
"allocated":{
"zoneid":1595331866,
"zonename":"default",
"nodename":"cscale-82-239",
"nodeid":4
},
"bundle_path":"\/usr\/local\/robin\/collections\/file-collection-1595307896158\/1595307917814\/mysql-5.7",
"host_ip":"172.21.24.104",
"appid":43,
"mem":{
"hugepages_2m":0,
"size":1073741824,
"hugepages_1g":0
},
"gpu":{
"max":0,
"min":0
},
"state":"STARTED",
"enable_metrics":true,
"allocated_host_public_ip":"10.9.82.239",
"commandline":"-W",
"cpu":{
"max":1,
"min":0
},
"allocated_host_type":"physical",
"allocated_host":"cscale-82-239.robinsystems.com",
"role":"mysql",
"ctime":1599592323,
"volume_groups":[
{
"stormgr_id":56,
"name":"lak.mysql.01.72.1.2519c51d-f90d-4753-9fd8-bc689b32938c",
"layout":"round-robin",
"volumes":[
"lak.mysql.01.data.1.db34409d-5077-4505-9382-b74cab487726"
],
"media":"HDD",
"device_sets":[
{
"stormgr_id":75,
"name":"lak.mysql.01.72.1.2519c51d-f90d-4753-9fd8-bc689b32938c.0.cc0ba584-9372-4828-9058-24918a6093a9",
"devices":[
{
"role":"Storage",
"max_throughput_intensive_vols_per_disk":1,
"pused":1006632960,
"reattachable":0,
"protected":0,
"max_latency_sensitive_vols_per_disk":2,
"wwn":"0x6002248067f958fce9788c6f585a1eb7",
"psize":107374182400,
"hostname":"cscale-82-239.robinsystems.com",
"write_unit":4096,
"aslices":49,
"slices":77,
"capacity":107374182400,
"tags":{
},
"allocated_slices":2,
"stormgr_id":6,
"type":"HDD",
"state":"READY",
"score":74,
"devpath":"\/dev\/disk\/by-id\/scsi-36002248067f958fce9788c6f585a1eb7",
"max_volumes_per_disk":40,
"host":"cscale-82-239.robinsystems.com"
}
]
}
],
"rpoolid":1,
"replicas":1
}
],
"restart_num":15,
"pod_name":"lak-mysql-01",
"vnodeid":16,
"engine":"docker",
"appname":"lak",
"storage":[
{
"faultdomain":"host",
"protection":0,
"snap_reserved":20,
"media":"HDD",
"encryption":"none",
"workload":0,
"fstype":"ext4",
"replication":1,
"layout":"round-robin",
"volgrp_name":"lak.mysql.01.72.1.2519c51d-f90d-4753-9fd8-bc689b32938c",
"snapname":"snap1",
"lvm_vol_count":"0",
"path":"\/var\/lib\/mysql",
"compression":"disabled",
"blocksize":4096,
"k8s_name":"lak-mysql-01-data-1-db34409d",
"vol_ns":"t001-u000003",
"disk_tags":{
},
"allocated":{
"media":72,
"stordriver":{
"media":"HDD",
"type":"das",
"faultdomain":"host",
"protection":0
},
"replication":1,
"next_backupid":1,
"appname":"default",
"resource_poolid":1,
"vtype":0,
"current_snapshotid":1,
"slice_size":1073741824,
"protection":0,
"multinode_mounting":false,
"volumeid":"56",
"compression":0,
"priority":2,
"params":{
},
"qgroupid":58,
"next_snapshotid":2,
"appid":1,
"name":"lak.mysql.01.data.1.db34409d-5077-4505-9382-b74cab487726",
"block_size":4096,
"snapshot_space_limit":214748365,
"current_snapshot":"active_snap",
"size":1073741824,
"genkey":1599592280515667,
"snapname":"snap1",
"grpid":56,
"partitions":0
},
"lvm_type":"None",
"type":"data",
"snapshot_space_limit":214748365,
"size":1073741824,
"name":"lak.mysql.01.data.1.db34409d-5077-4505-9382-b74cab487726",
"pvcpolicy":"create",
"stordriver":{
"media":"HDD",
"type":"das",
"faultdomain":"host",
"protection":0
}
}
],
"services":[
{
"vnodename":"lak-mysql-01",
"selectors":{
"robin.io\/vnode":"lak-mysql-01"
},
"labels":{
"namespace":"t001-u000003",
"robin.io\/username":"robin",
"robin.io\/tenant_id":"1",
"robin.io\/user_id":"3",
"scope":"vnode",
"robin.io\/tenant":"Administrators"
},
"appname":"lak",
"k8s_name":"lak-mysql-01-np-0",
"ports":[
{
"port":3306,
"name":"tcp-port3306",
"protocol":"TCP",
"target_port":3306,
"node_port":30640
}
],
"cluster_ip":"172.19.45.11",
"type":"NodePort"
}
],
"env":{
"MYSQL_USER":{
"type":"text",
"value":"robin"
},
"MYSQL_DATABASE":{
"type":"text",
"value":"robin"
},
"allocated":{
"MYSQL_USER":"robin",
"ROBINHOST_TAG_ROBINHOST":"cscale-82-239",
"ROBINHOST_TAG_KUBERNETES.IO-ARCH":"amd64",
"ROBINHOST_TAG_NODETYPE":"robin-node",
"MYSQL_PASSWORD":"robin123",
"POD_NS":"t001-u000003",
"ROBINHOST":"cscale-82-239.robinsystems.com",
"POD_NAME":"lak-mysql-01",
"MYSQL_ROOT_PASSWORD":"robin123",
"K8S_NODE":"cscale-82-239",
"MYSQL_DATABASE":"robin",
"ROBINHOST_TAG_DOMAIN":"ROBIN",
"ROBINHOST_TAG_RNODETYPE":"robin-worker-node",
"ROBINHOST_TAG_ROBINRPOOL":"default",
"ROBINHOST_TAG_KUBERNETES.IO-OS":"linux"
},
"MYSQL_ROOT_PASSWORD":{
"type":"password",
"value":"robin123"
},
"MYSQL_PASSWORD":{
"type":"password",
"value":"robin123"
}
},
"root_fs":"\/usr\/local\/robin\/instances\/lak-mysql-01.t001-u000003.svc.cluster.local",
"restart_on_qoscfg":true,
"k8s_provider":"robin",
"vnodehookargs":{
"postdestroy":[
"opr=postdestroy"
],
"prestart":[
"opr=prestart"
],
"postcreate":[
],
"poststart":[
],
"postrollback":[
],
"postgrow":[
],
"poststop":[
"opr=poststop"
],
"pregrow":[
"opr=pregrow"
],
"prerollback":[
"opr=prerollback"
],
"preclone":[
"opr=preclone"
],
"prestop":[
"opr=prestop"
],
"precreate":[
"opr=precreate"
],
"postsnapshot":[
],
"postclone":[
],
"presnapshot":[
],
"predestroy":[
"opr=predestroy"
]
},
"role_name":"mysql",
"name":"lak.mysql.01",
"cm_keys":[
"ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDKS44FJBT75q64OPV8s1WL\/lFbMogtnSm9wk6i+uQArrteNI6DhMYnBV8GC+Dttr2sxurxm\/QEW3Pa9OKhtCtT\/CQ0h+w7u8f8Mu77zAtAd4rhFAtuK86wiZPp8vSRp3Q2l7TMC31VV08wa7fulk\/SSF6maJRQxxmH2lNOsHYOHZve4TSZ+FuGT5h0KMAtGjy7jDSfdt4nBFb\/EzVuUE70y8x8q7SmObQGCDBoQlC\/QwcmBJ+T25l7fDfVTSXSjCRb2wN2DIxUA7Cr1hNRoZNPAAFahq+jWYYS+aKaXVe6cR6GEtgQ66ey7Zn8ZHOrmW9n9LEnYT\/CmzV6l4gwfyIp root@cscale-82-236",
"ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQCxdMba+MjIxpx8IzmIodVTs13BJj3BAsRaeOpIC3g07eKcb\/WCJ3E9kFvOyJzqX1KmOpYqwtYG0zTwd+xPlc9fudEoORLM2jAt5JZQliT8IDGLyRYqhsOaL+HPKeO8VU9u0sd8938OXGKEJQ1Qt0DQcXuXTSDYGefS24TaWxJ6r\/bbM0WXYrJiFc83LemUHGq\/vdNpXNbGiAMPCTF3\/ZkHsIQTJd8dmBXn3VsEcRbvSGnHIXvQjRZRJp5hBVl\/zFZtGFuT7Rs1IVpZtsO81hFCkgAX\/jonSglX193+A5oCFPeTsfOD01A3r9x3qdcgtSwxkU5ElmksR6BNt0pXenO7 root@cscale-82-238",
"ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQCwaDQ4NFtH5X1NVdUW\/trWG0W3LaLOQdz0LIwTMiYo707zpW5STz6R4qRCyonqA5DGx9KicnDvbLYXrDtEFczf68j3N9mgm4QKQ5NAUsKgCrXD\/musfl7T0kwmADh4tWI1pbnEJNAfY+xOvKqd1MQIoXNY3jDHlZghb0un+ZnCkxlEwLNUEZySdVhuUitK6fH0abpbLDSWAqqWvzBQMeTYVD91KJPqQXPyejQcjw31dmFYQJ+Ru7Nm0+iifXIZ4poyGZuxNZL9K0F4j+mS+LQav+dAnQGfL62HyAZhHmFoqF9l1GQs6qwrWU6UaZPLAt3XaghtDJwXTks6vEkjibNN root@cscale-82-237"
],
"utime":1599592323,
"pod_ns":"t001-u000003",
"bundleid":4,
"id":16
}
],
"image":{
"entrypoint":"custom-entrypoint.sh",
"engine":"docker",
"version":"5.7",
"registry_hostname":"",
"name":"mysql",
"registry_port":""
},
"commandline":"-W",
"volume_groups":[
],
"display_name":"Runs mysql database server",
"qgroups":{
"data":{
"rd_min_iops":0,
"enabled":false,
"wr_min_iops":0,
"priority":1,
"rd_weight":1,
"wr_max_iops":2000000,
"wr_weight":1,
"rd_max_iops":2000000,
"wr_min_window":500,
"rd_min_window":500
}
},
"restart_on_qoscfg":true,
"name":"mysql",
"service_ports":[
3306
]
}
],
"desc":"",
"rpool":"default",
"enable_hooklogs":true,
"bundle_object_id":"7be85809d7ecf1544e461df868f163ad",
"from_template":null,
"parentid":43,
"clonemode":"unfenced",
"auto_relocate":true,
"name":"lak_snap1",
"clone":"enabled",
"snapname":"snap1",
"robin_version":"5.3.1-349",
"snapshot":"enabled",
"parent_last_known_state":6,
"restart_num":15,
"namespace":"t001-u000003",
"planid":522,
"rpoolid":1,
"tenant":"Administrators",
"content_id":"7be85809d7ecf1544e461df868f163ad",
"bundle_path":"\/usr\/local\/robin\/collections\/file-collection-1595307896158\/1595307917814\/mysql-5.7",
"app_ns":"t001-u000003",
"bundleid":4,
"master_name":"lak",
"apphooks":{
"postdestroy":"bash app_sample postdestroy",
"prestart":"bash app_sample prestart",
"validate":"python3.4 validate_template.py",
"health":"python3.4 health.py",
"postcreate":"bash app_sample postcreate",
"poststart":"bash app_sample poststart",
"allocated":{
"prestart":"bash app_sample prestart",
"validate":"python3.4 validate_template.py",
"health":"python3.4 health.py",
"postcreate":"bash app_sample postcreate",
"poststart":"bash app_sample poststart",
"postgrow":"bash app_sample postgrow",
"postrollback":"bash app_sample postrollback",
"poststop":"bash app_sample poststop",
"pregrow":"bash app_sample pregrow",
"prerollback":"bash app_sample prerollback",
"preclone":"bash app_sample preclone",
"prestop":"bash app_sample prestop",
"precreate":"bash app_sample precreate",
"postsnapshot":"bash app_sample postsnapshot",
"presnapshot":"bash app_sample presnapshot",
"postclone":"bash app_sample postclone",
"postdestroy":"bash app_sample postdestroy",
"predestroy":"bash app_sample predestroy"
},
"postrollback":"bash app_sample postrollback",
"postgrow":"bash app_sample postgrow",
"poststop":"bash app_sample poststop",
"pregrow":"bash app_sample pregrow",
"prerollback":"bash app_sample prerollback",
"preclone":"bash app_sample preclone",
"prestop":"bash app_sample prestop",
"precreate":"bash app_sample precreate",
"postsnapshot":"bash app_sample postsnapshot",
"postclone":"bash app_sample postclone",
"presnapshot":"bash app_sample presnapshot",
"predestroy":"bash app_sample predestroy"
},
"enable_metrics":true,
"zoneid":1595331866,
"id":43,
"pvcpolicy":"create",
"username":"robin"
},
"orig_app":{
"roles":[
{
"qgroups":{
"data":{
"rd_min_iops":0,
"wr_min_iops":0,
"wr_weight":1,
"priority":1,
"rd_weight":1,
"wr_max_iops":2000000,
"enabled":false,
"rd_max_iops":2000000,
"wr_min_window":500,
"rd_min_window":500
}
},
"image":{
"entrypoint":"custom-entrypoint.sh",
"engine":"docker",
"version":"5.7",
"registry_hostname":"",
"name":"mysql",
"registry_port":""
},
"commandline":"-W",
"restart_on_qoscfg":true,
"volume_groups":[
],
"display_name":"Runs mysql database server",
"vnodes":[
{
"service_uids":[
"390f55e2-56dd-46f1-8c94-4f0c38c92aeb"
],
"rpoolid":1,
"network":[
{
"subnet":"172.21.0.0",
"ippool":"robin-default",
"interfaces":1,
"allocated_ip":"172.21.24.104",
"allocated_prefix":16,
"name":"robin-default",
"allocated_by":"system",
"driver":"calico",
"allocated_names":[
"eth0"
],
"allocated_netmask":"255.255.0.0"
}
],
"sidecar_info":{
"mem":0,
"gpu":0,
"hugepages_2m":0,
"containers":[
],
"cpu":0,
"hugepages_1g":0
},
"hosttags":{
"robin.io\/robinrpool":[
"default"
],
"robinrpool":[
"default"
],
"rnodetype":[
"robin-worker-node"
],
"nodetype":[
"robin-node"
],
"domain":[
"ROBIN"
],
"kubernetes.io\/os":[
"linux"
],
"robinhost":[
"cscale-82-239"
],
"kubernetes.io\/arch":[
"amd64"
]
},
"enable_hooklogs":true,
"cmdlineargs":"-W",
"vnodehooks":{
"postdestroy":"bash vnode_sample opr=postdestroy",
"prestart":"bash vnode_sample opr=prestart",
"postcreate":"bash check_mysql",
"poststart":"bash check_mysql",
"postrollback":"bash check_mysql",
"postgrow":"bash check_mysql",
"poststop":"bash vnode_sample opr=poststop",
"pregrow":"bash vnode_sample opr=pregrow",
"prerollback":"bash vnode_sample opr=prerollback",
"preclone":"bash vnode_sample opr=preclone",
"prestop":"bash vnode_sample opr=prestop",
"precreate":"bash vnode_sample opr=precreate",
"postsnapshot":"bash unquiesce.sh",
"postclone":"bash check_mysql",
"presnapshot":"bash quiesce.sh",
"predestroy":"bash vnode_sample opr=predestroy"
},
"hostname":"lak-mysql-01.t001-u000003.svc.cluster.local",
"bundle_object_id":"7be85809d7ecf1544e461df868f163ad",
"enable_portmapping":true,
"image":{
"entrypoint":"custom-entrypoint.sh",
"engine":"docker",
"version":"5.7",
"registry_hostname":"",
"name":"mysql",
"registry_port":""
},
"numa_allocations":{
"0":{
"gpu_used":0,
"isol_dedicated_cores_used":0,
"hugepages_1g_used":0,
"non_isol_cores_used":1,
"isol_shared_cores_used":0,
"hugepages_2m_used":0,
"mem_used":1073741824
}
},
"commandline":"-W",
"calico_inuse":true,
"allocated_host_public_hostname":"cscale-82-239.robinsystems.com",
"allocated":{
"zoneid":1595331866,
"zonename":"default",
"nodename":"cscale-82-239",
"nodeid":4
},
"bundle_path":"\/usr\/local\/robin\/collections\/file-collection-1595307896158\/1595307917814\/mysql-5.7",
"host_ip":"172.21.24.104",
"appid":43,
"mem":{
"hugepages_1g":0,
"size":1073741824,
"hugepages_2m":0
},
"gpu":{
"max":0,
"min":0
},
"storage":[
{
"faultdomain":"host",
"snapshot_space_limit":214748365,
"snap_reserved":20,
"media":"HDD",
"encryption":"none",
"workload":0,
"fstype":"ext4",
"replication":1,
"layout":"round-robin",
"volgrp_name":"lak.mysql.01.72.1.2519c51d-f90d-4753-9fd8-bc689b32938c",
"lvm_vol_count":"0",
"path":"\/var\/lib\/mysql",
"compression":"disabled",
"type":"data",
"blocksize":4096,
"k8s_name":"lak-mysql-01-data-1-db34409d",
"vol_ns":"t001-u000003",
"disk_tags":{
},
"allocated":{
"media":72,
"replication":1,
"next_backupid":1,
"appname":"default",
"resource_poolid":1,
"vtype":0,
"current_snapshotid":2,
"next_snapshotid":2,
"compression":0,
"multinode_mounting":false,
"volumeid":"56",
"priority":2,
"params":{
},
"snapshot_space_limit":214748365,
"qgroupid":58,
"slice_size":1073741824,
"appid":1,
"name":"lak.mysql.01.data.1.db34409d-5077-4505-9382-b74cab487726",
"block_size":4096,
"protection":0,
"current_snapshot":"active_snap",
"size":1073741824,
"partitions":0,
"genkey":1599592280515667,
"grpid":56,
"stordriver":{
"media":"HDD",
"type":"das",
"faultdomain":"host",
"protection":0
}
},
"lvm_type":"None",
"name":"lak.mysql.01.data.1.db34409d-5077-4505-9382-b74cab487726",
"protection":0,
"size":1073741824,
"pvcpolicy":"create",
"stordriver":{
"media":"HDD",
"type":"das",
"faultdomain":"host",
"protection":0
}
}
],
"enable_metrics":true,
"allocated_host_public_ip":"10.9.82.239",
"state":"STARTED",
"cpu":{
"max":1,
"min":0
},
"allocated_host_type":"physical",
"allocated_host":"cscale-82-239.robinsystems.com",
"role":"mysql",
"ctime":1599592323,
"volume_groups":[
{
"rpoolid":1,
"name":"lak.mysql.01.72.1.2519c51d-f90d-4753-9fd8-bc689b32938c",
"device_sets":[
{
"name":"lak.mysql.01.72.1.2519c51d-f90d-4753-9fd8-bc689b32938c.0.cc0ba584-9372-4828-9058-24918a6093a9",
"stormgr_id":75,
"devices":[
{
"role":"Storage",
"max_throughput_intensive_vols_per_disk":1,
"pused":1006632960,
"reattachable":0,
"protected":0,
"max_latency_sensitive_vols_per_disk":2,
"wwn":"0x6002248067f958fce9788c6f585a1eb7",
"psize":107374182400,
"hostname":"cscale-82-239.robinsystems.com",
"write_unit":4096,
"aslices":49,
"slices":77,
"capacity":107374182400,
"tags":{
},
"allocated_slices":2,
"stormgr_id":6,
"type":"HDD",
"state":"READY",
"score":74,
"devpath":"\/dev\/disk\/by-id\/scsi-36002248067f958fce9788c6f585a1eb7",
"max_volumes_per_disk":40,
"host":"cscale-82-239.robinsystems.com"
}
]
}
],
"volumes":[
"lak.mysql.01.data.1.db34409d-5077-4505-9382-b74cab487726"
],
"layout":"round-robin",
"media":"HDD",
"stormgr_id":56,
"replicas":1
}
],
"restart_num":15,
"pod_name":"lak-mysql-01",
"vnodeid":16,
"engine":"docker",
"appname":"lak",
"services":[
{
"vnodename":"lak-mysql-01",
"selectors":{
"robin.io\/vnode":"lak-mysql-01"
},
"labels":{
"namespace":"t001-u000003",
"robin.io\/username":"robin",
"robin.io\/tenant":"Administrators",
"robin.io\/user_id":"3",
"scope":"vnode",
"robin.io\/tenant_id":"1"
},
"appname":"lak",
"k8s_name":"lak-mysql-01-np-0",
"ports":[
{
"protocol":"TCP",
"name":"tcp-port3306",
"port":3306,
"target_port":3306,
"node_port":30640
}
],
"cluster_ip":"172.19.45.11",
"type":"NodePort"
}
],
"env":{
"MYSQL_USER":{
"type":"text",
"value":"robin"
},
"MYSQL_DATABASE":{
"type":"text",
"value":"robin"
},
"allocated":{
"MYSQL_USER":"robin",
"ROBINHOST_TAG_ROBINHOST":"cscale-82-239",
"ROBINHOST_TAG_KUBERNETES.IO-ARCH":"amd64",
"POD_NS":"t001-u000003",
"ROBINHOST_TAG_NODETYPE":"robin-node",
"MYSQL_PASSWORD":"robin123",
"POD_NAME":"lak-mysql-01",
"ROBINHOST":"cscale-82-239.robinsystems.com",
"ROBINHOST_TAG_ROBINRPOOL":"default",
"K8S_NODE":"cscale-82-239",
"MYSQL_DATABASE":"robin",
"ROBINHOST_TAG_DOMAIN":"ROBIN",
"ROBINHOST_TAG_RNODETYPE":"robin-worker-node",
"MYSQL_ROOT_PASSWORD":"robin123",
"ROBINHOST_TAG_KUBERNETES.IO-OS":"linux"
},
"MYSQL_ROOT_PASSWORD":{
"type":"password",
"value":"robin123"
},
"MYSQL_PASSWORD":{
"type":"password",
"value":"robin123"
}
},
"root_fs":"\/usr\/local\/robin\/instances\/lak-mysql-01.t001-u000003.svc.cluster.local",
"restart_on_qoscfg":true,
"k8s_provider":"robin",
"vnodehookargs":{
"prestart":[
"opr=prestart"
],
"postcreate":[
],
"poststart":[
],
"postgrow":[
],
"postrollback":[
],
"poststop":[
"opr=poststop"
],
"pregrow":[
"opr=pregrow"
],
"prerollback":[
"opr=prerollback"
],
"preclone":[
"opr=preclone"
],
"prestop":[
"opr=prestop"
],
"precreate":[
"opr=precreate"
],
"postsnapshot":[
],
"presnapshot":[
],
"postclone":[
],
"postdestroy":[
"opr=postdestroy"
],
"predestroy":[
"opr=predestroy"
]
},
"role_name":"mysql",
"name":"lak.mysql.01",
"cm_keys":[
"ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDKS44FJBT75q64OPV8s1WL\/lFbMogtnSm9wk6i+uQArrteNI6DhMYnBV8GC+Dttr2sxurxm\/QEW3Pa9OKhtCtT\/CQ0h+w7u8f8Mu77zAtAd4rhFAtuK86wiZPp8vSRp3Q2l7TMC31VV08wa7fulk\/SSF6maJRQxxmH2lNOsHYOHZve4TSZ+FuGT5h0KMAtGjy7jDSfdt4nBFb\/EzVuUE70y8x8q7SmObQGCDBoQlC\/QwcmBJ+T25l7fDfVTSXSjCRb2wN2DIxUA7Cr1hNRoZNPAAFahq+jWYYS+aKaXVe6cR6GEtgQ66ey7Zn8ZHOrmW9n9LEnYT\/CmzV6l4gwfyIp root@cscale-82-236",
"ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQCxdMba+MjIxpx8IzmIodVTs13BJj3BAsRaeOpIC3g07eKcb\/WCJ3E9kFvOyJzqX1KmOpYqwtYG0zTwd+xPlc9fudEoORLM2jAt5JZQliT8IDGLyRYqhsOaL+HPKeO8VU9u0sd8938OXGKEJQ1Qt0DQcXuXTSDYGefS24TaWxJ6r\/bbM0WXYrJiFc83LemUHGq\/vdNpXNbGiAMPCTF3\/ZkHsIQTJd8dmBXn3VsEcRbvSGnHIXvQjRZRJp5hBVl\/zFZtGFuT7Rs1IVpZtsO81hFCkgAX\/jonSglX193+A5oCFPeTsfOD01A3r9x3qdcgtSwxkU5ElmksR6BNt0pXenO7 root@cscale-82-238",
"ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQCwaDQ4NFtH5X1NVdUW\/trWG0W3LaLOQdz0LIwTMiYo707zpW5STz6R4qRCyonqA5DGx9KicnDvbLYXrDtEFczf68j3N9mgm4QKQ5NAUsKgCrXD\/musfl7T0kwmADh4tWI1pbnEJNAfY+xOvKqd1MQIoXNY3jDHlZghb0un+ZnCkxlEwLNUEZySdVhuUitK6fH0abpbLDSWAqqWvzBQMeTYVD91KJPqQXPyejQcjw31dmFYQJ+Ru7Nm0+iifXIZ4poyGZuxNZL9K0F4j+mS+LQav+dAnQGfL62HyAZhHmFoqF9l1GQs6qwrWU6UaZPLAt3XaghtDJwXTks6vEkjibNN root@cscale-82-237"
],
"utime":1599592323,
"pod_ns":"t001-u000003",
"bundleid":4,
"id":16
}
],
"name":"mysql",
"service_ports":[
3306
]
}
],
"rpool":"default",
"enable_hooklogs":true,
"bundle_object_id":"7be85809d7ecf1544e461df868f163ad",
"clonemode":"unfenced",
"auto_relocate":true,
"name":"lak",
"clone":"enabled",
"from_template":null,
"robin_version":"5.3.1-349",
"snapshot":"enabled",
"restart_num":15,
"namespace":"t001-u000003",
"planid":522,
"rpoolid":1,
"tenant":"Administrators",
"content_id":"7be85809d7ecf1544e461df868f163ad",
"bundle_path":"\/usr\/local\/robin\/collections\/file-collection-1595307896158\/1595307917814\/mysql-5.7",
"app_ns":"t001-u000003",
"bundleid":4,
"apphooks":{
"prestart":"bash app_sample prestart",
"validate":"python3.4 validate_template.py",
"health":"python3.4 health.py",
"postcreate":"bash app_sample postcreate",
"poststart":"bash app_sample poststart",
"allocated":{
"postdestroy":"bash app_sample postdestroy",
"prestart":"bash app_sample prestart",
"validate":"python3.4 validate_template.py",
"health":"python3.4 health.py",
"postcreate":"bash app_sample postcreate",
"poststart":"bash app_sample poststart",
"postrollback":"bash app_sample postrollback",
"postgrow":"bash app_sample postgrow",
"poststop":"bash app_sample poststop",
"pregrow":"bash app_sample pregrow",
"prerollback":"bash app_sample prerollback",
"preclone":"bash app_sample preclone",
"prestop":"bash app_sample prestop",
"precreate":"bash app_sample precreate",
"postsnapshot":"bash app_sample postsnapshot",
"postclone":"bash app_sample postclone",
"presnapshot":"bash app_sample presnapshot",
"predestroy":"bash app_sample predestroy"
},
"postrollback":"bash app_sample postrollback",
"postgrow":"bash app_sample postgrow",
"poststop":"bash app_sample poststop",
"pregrow":"bash app_sample pregrow",
"prerollback":"bash app_sample prerollback",
"preclone":"bash app_sample preclone",
"prestop":"bash app_sample prestop",
"precreate":"bash app_sample precreate",
"postsnapshot":"bash app_sample postsnapshot",
"presnapshot":"bash app_sample presnapshot",
"postclone":"bash app_sample postclone",
"postdestroy":"bash app_sample postdestroy",
"predestroy":"bash app_sample predestroy"
},
"enable_metrics":true,
"zoneid":1595331866,
"username":"robin",
"pvcpolicy":"create",
"id":43
}
},
"jobid":744
}
10.25. Configure Snapshot Space Limits for an Application¶
Use the following command to configure an application’s snapshot space limit:
# robin app snapshot-space-limit <app_name>
--role <role>
--volume-type <volume_type>
--snapshot-space-limit <snap_limit>
--role-values <rolestr>
--all
|
Application instance name |
|
Application Role Name (required if –all is not specified) |
|
Volume type within the role (required if –role is specified) |
|
Snapshot space limit in bytes for volumes of the given type or Snapshot space percentage for all volumes of the app |
|
Specify values for multiple roles and vtypes in app i.e. <role1>:<vtype1>:<snaplimit> <role2>:<vtype2>:<snaplimit> |
|
Configure snapshot space for all roles |
Example:
# robin app snapshot-space-limit mysql1 --all -l 3% --wait
Job: 227 Name: ApplicationSnapshotSpaceLimitUpdate State: VALIDATED Error: 0
Job: 227 Name: ApplicationSnapshotSpaceLimitUpdate State: COMPLETED Error: 0
Configures the snapshot space limit for an application.
End Point: /api/v3/robin_server/robin_server/apps/<appname>
Method: PUT
URL Parameters: None
Data Parameters:
action: snapshot_limits- This mandatory field within the payload specifies that the snapshot limits of an application are to be modified.limits: <list_of_dicts>–role: <role_name>- This mandatory field within each dictionary specifies the role of the volumes that need to be modified.snapshot_space_limit: <snapshot_limit>- This mandatory field within each dictionary specifies the total snapshot space limit of each volume (in bytes) that meets the type and role provided.vol_type: <vol_type- This mandatory field within each dictionary specifies the type of the volumes within the given role that need to be modified.
Port: RCM Port (default value is 29442)
Headers:
Authorization: <auth_token>: Authorization token to identify which user is sending the request. The token can be acquired from the login API.
Success Response Code: 202
Error Response Code: 500 (Internal Server Error), 404 (Not Found Error), 401 (Unauthorized Error), 400 (Invalid API Usage Error)
Example Response:
Output
{
"plan":{
"current_user":{
"tenant_id":1,
"username":"robin",
"user_context":"robin",
"namespace":"t001-u000003",
"tenant_role":"superadmin",
"ip_addr":"172.17.0.1",
"user_permissions":{
},
"user_contexts":[
"robin"
],
"user_id":3,
"session_expires":"2020-09-09T00:09:15",
"tenant":"Administrators",
"tenants":[
"Administrators"
],
"user_capabilities":[
"AllSuperAdminCapabilities"
]
},
"action":"snapshot_limits",
"appdata":{
"username":"robin",
"rpool":"default",
"content_id":"017a9be81a251ab7adae390a6249b7f5",
"namespace":"t001-u000003",
"auto_relocate":true,
"rpoolid":1,
"restart_num":15,
"bundleid":1,
"id":31,
"pvcpolicy":"create",
"enable_metrics":true,
"bundle_object_id":"017a9be81a251ab7adae390a6249b7f5",
"tenant":"Administrators",
"roles":[
{
"restart_on_qoscfg":true,
"qgroups":{
"data":{
"rd_max_iops":2000000,
"rd_weight":1,
"wr_weight":1,
"rd_min_window":500,
"wr_min_window":500,
"priority":1,
"enabled":false,
"wr_min_iops":0,
"wr_max_iops":2000000,
"rd_min_iops":0
},
"block":{
"rd_max_iops":2000000,
"rd_weight":1,
"wr_weight":1,
"rd_min_window":500,
"wr_min_window":500,
"priority":1,
"enabled":false,
"wr_min_iops":0,
"wr_max_iops":2000000,
"rd_min_iops":0
}
},
"display_name":"server",
"image":{
"engine":"docker",
"version":"7",
"registry_hostname":"",
"entrypoint":"entry.sh",
"name":"robinsys\/centos",
"registry_port":"",
"init_mode":false
},
"name":"server",
"vnodes":[
{
"allocated_host_type":"physical",
"hosttags":{
"robin.io\/robinrpool":[
"default"
],
"kubernetes.io\/os":[
"linux"
],
"kubernetes.io\/arch":[
"amd64"
]
},
"image":{
"engine":"docker",
"version":"7",
"registry_hostname":"",
"entrypoint":"entry.sh",
"name":"robinsys\/centos",
"registry_port":"",
"init_mode":false
},
"rpoolid":1,
"allocated_host_public_ip":"10.9.82.140",
"restart_num":15,
"bundleid":1,
"role_name":"server",
"utime":1599164742,
"id":31,
"cpu":{
"max":1,
"min":0,
"reserve":false
},
"env":{
"ROOT_PASSWORD":{
"type":"password",
"value":""
},
"DOCKER_OPTS":{
"type":"text",
"value":"-v \/sys\/fs\/cgroup:\/sys\/fs\/cgroup --cap-add=SYS_ADMIN"
},
"allocated":{
"ROBINHOST":"cscale-82-140.robinsystems.com",
"ROBINHOST_TAG_KUBERNETES.IO-ARCH":"amd64",
"ROBINHOST_TAG_KUBERNETES.IO-OS":"linux",
"POD_NAME":"lak-server-01",
"ROOT_PASSWORD":"",
"ROBINHOST_TAG_ROBINRPOOL":"default",
"K8S_NODE":"cscale-82-140",
"DOCKER_OPTS":"-v \/sys\/fs\/cgroup:\/sys\/fs\/cgroup --cap-add=SYS_ADMIN",
"ENABLE_SSH":true,
"POD_NS":"t001-u000003"
},
"ENABLE_SSH":{
"type":"boolean",
"value":true
}
},
"ctime":1599164742,
"enable_hooklogs":true,
"pod_name":"lak-server-01",
"calico_inuse":true,
"appname":"lak",
"vnodehooks":{
"postcreate":"bash postcreate.sh"
},
"service_uids":[
],
"engine":"docker",
"role":"server",
"name":"lak.server.01",
"allocated":{
"zonename":"default",
"nodeid":1,
"nodename":"cscale-82-140",
"zoneid":1598666199
},
"appid":31,
"root_fs":"\/usr\/local\/robin\/instances\/lak-server-01.t001-u000003.svc.cluster.local",
"vnodeid":31,
"mem":{
"hugepages_1g":0,
"size":209715200,
"hugepages_2m":0
},
"storage":[
{
"snapshot_space_limit":214748365,
"fstype":"ext4",
"vol_ns":"t001-u000003",
"compression":"disabled",
"snap_reserved":20,
"layout":"round-robin",
"media":"HDD",
"volgrp_name":"lak.server.01.72.1.79604a77-a02e-4293-9e4a-ff5a23bfb74c",
"pvcpolicy":"create",
"encryption":"none",
"replication":1,
"size":1073741824,
"k8s_name":"lak-server-01-data-1-be9e603f",
"disk_tags":{
},
"workload":0,
"protection":0,
"path":"\/data",
"lvm_vol_count":"0",
"stordriver":{
"faultdomain":"host",
"protection":0,
"media":"HDD",
"type":"das"
},
"faultdomain":"host",
"type":"data",
"lvm_type":"None",
"name":"lak.server.01.data.1.be9e603f-8c52-4472-9aa6-c8a9ada07ae3",
"allocated":{
"resource_poolid":1,
"snapshot_space_limit":214748365,
"compression":0,
"slice_size":1073741824,
"params":{
},
"partitions":0,
"genkey":1599164729997502,
"current_snapshotid":1,
"next_backupid":1,
"replication":1,
"size":1073741824,
"current_snapshot":"active_snap",
"grpid":64,
"priority":2,
"volumeid":"65",
"appname":"default",
"next_snapshotid":2,
"stordriver":{
"faultdomain":"host",
"protection":0,
"media":"HDD",
"type":"das"
},
"protection":0,
"media":72,
"vtype":0,
"multinode_mounting":false,
"qgroupid":64,
"name":"lak.server.01.data.1.be9e603f-8c52-4472-9aa6-c8a9ada07ae3",
"block_size":4096,
"appid":1
},
"blocksize":4096
},
{
"snapshot_space_limit":214748365,
"fstype":"raw",
"vol_ns":"t001-u000003",
"compression":"disabled",
"snap_reserved":20,
"layout":"round-robin",
"media":"HDD",
"volgrp_name":"lak.server.01.72.1.dfedd742-66bc-4b3c-b626-01c581d12cc5",
"pvcpolicy":"create",
"encryption":"none",
"replication":1,
"size":1073741824,
"k8s_name":"lak-server-01-block-1-52af20de",
"disk_tags":{
},
"workload":0,
"protection":0,
"path":"\/dev\/rda",
"lvm_vol_count":"0",
"stordriver":{
"faultdomain":"host",
"protection":0,
"media":"HDD",
"type":"das"
},
"faultdomain":"host",
"type":"block",
"lvm_type":"None",
"name":"lak.server.01.block.1.52af20de-9a7e-40f5-a9b0-65e191ea5564",
"allocated":{
"resource_poolid":1,
"snapshot_space_limit":214748365,
"compression":0,
"slice_size":1073741824,
"params":{
},
"partitions":0,
"genkey":1599164729992109,
"current_snapshotid":1,
"next_backupid":1,
"replication":1,
"size":1073741824,
"current_snapshot":"active_snap",
"grpid":65,
"priority":2,
"volumeid":"64",
"appname":"default",
"next_snapshotid":2,
"stordriver":{
"faultdomain":"host",
"protection":0,
"media":"HDD",
"type":"das"
},
"protection":0,
"media":72,
"vtype":0,
"multinode_mounting":false,
"qgroupid":65,
"name":"lak.server.01.block.1.52af20de-9a7e-40f5-a9b0-65e191ea5564",
"block_size":4096,
"appid":1
},
"blocksize":4096
}
],
"cm_keys":[
"ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDBZg2sAe0kUqoIEPV6dMQ99U\/9rSmZbF70M5s1Ys39cYPEkkWHMAnWHe6Vj1cDik+wSPV6qk4EiV7tTi+nwTQzbiJx67FcF29i1WLvVtc0xXSNo9zkJTHG4CONg79UoW8F6GnrHD+NJiQAdenQAcThnFGJoqaqn\/ohxcuTV3rnc+W84EAlCPVEa3mzvFzu0hXFDN6JrbcYBdG8BU2xrUGM3PaQZRGay6ZbpQSLlFY8XevAO4iTeMfkBRJxFGNEE0zFpVwwtVfNHsCAkfqmSt4kM68OdS4ZdHmjPsIjzyhWJPMnnqJ17vWGUHLEfMxvY2Nb5dCSR\/SAoHVXTtItGFYT root@cscale-82-140"
],
"hostname":"lak-server-01.t001-u000003.svc.cluster.local",
"allocated_host":"cscale-82-140.robinsystems.com",
"gpu":{
"max":0,
"min":0
},
"numa_allocations":{
"0":{
"hugepages_1g_used":0,
"non_isol_cores_used":1,
"isol_dedicated_cores_used":0,
"mem_used":209715200,
"hugepages_2m_used":0,
"isol_shared_cores_used":0,
"gpu_used":0
}
},
"vnodehookargs":{
"postcreate":[
]
},
"network":[
{
"ippool":"robin-default",
"name":"robin-default",
"driver":"calico",
"subnet":"172.21.0.0",
"allocated_ip":"172.21.26.106",
"allocated_netmask":"255.255.0.0",
"interfaces":1,
"allocated_by":"system",
"allocated_names":[
"eth0"
],
"allocated_prefix":16
}
],
"enable_metrics":true,
"k8s_provider":"robin",
"host_ip":"172.21.26.106",
"allocated_host_public_hostname":"cscale-82-140.robinsystems.com",
"restart_on_qoscfg":true,
"bundle_path":"\/usr\/local\/robin\/collections\/file-collection-1598641146105\/1598641180179\/centos-1.0",
"pod_ns":"t001-u000003",
"state":"STARTED",
"enable_portmapping":true,
"bundle_object_id":"017a9be81a251ab7adae390a6249b7f5",
"sidecar_info":{
"cpu":0,
"hugepages_2m":0,
"hugepages_1g":0,
"gpu":0,
"containers":[
],
"mem":0
},
"volume_groups":[
{
"layout":"round-robin",
"media":"HDD",
"stormgr_id":64,
"device_sets":[
{
"devices":[
{
"capacity":107374182400,
"max_throughput_intensive_vols_per_disk":1,
"slices":77,
"tags":{
},
"aslices":13,
"type":"HDD",
"stormgr_id":2,
"hostname":"cscale-82-140.robinsystems.com",
"psize":107374182400,
"protected":0,
"devpath":"\/dev\/disk\/by-id\/scsi-3600224804c48fd7e16c608dea0919064",
"score":92,
"wwn":"0x600224804c48fd7e16c608dea0919064",
"write_unit":4096,
"reattachable":0,
"allocated_slices":2,
"max_volumes_per_disk":10,
"state":"READY",
"role":"Storage",
"max_latency_sensitive_vols_per_disk":2,
"pused":301989888,
"host":"cscale-82-140.robinsystems.com"
}
],
"name":"lak.server.01.72.1.79604a77-a02e-4293-9e4a-ff5a23bfb74c.0.54e6a270-a851-432d-8af3-e4a5724fd7ed",
"stormgr_id":64
}
],
"volumes":[
"lak.server.01.data.1.be9e603f-8c52-4472-9aa6-c8a9ada07ae3"
],
"name":"lak.server.01.72.1.79604a77-a02e-4293-9e4a-ff5a23bfb74c",
"rpoolid":1,
"replicas":1
},
{
"layout":"round-robin",
"media":"HDD",
"stormgr_id":65,
"device_sets":[
{
"devices":[
{
"capacity":107374182400,
"max_throughput_intensive_vols_per_disk":1,
"slices":77,
"tags":{
},
"aslices":13,
"type":"HDD",
"stormgr_id":2,
"hostname":"cscale-82-140.robinsystems.com",
"psize":107374182400,
"protected":0,
"devpath":"\/dev\/disk\/by-id\/scsi-3600224804c48fd7e16c608dea0919064",
"score":92,
"wwn":"0x600224804c48fd7e16c608dea0919064",
"write_unit":4096,
"reattachable":0,
"allocated_slices":2,
"max_volumes_per_disk":10,
"state":"READY",
"role":"Storage",
"max_latency_sensitive_vols_per_disk":2,
"pused":301989888,
"host":"cscale-82-140.robinsystems.com"
}
],
"name":"lak.server.01.72.1.dfedd742-66bc-4b3c-b626-01c581d12cc5.0.57785519-2999-404f-a8c1-c46bf24eb2a2",
"stormgr_id":65
}
],
"volumes":[
"lak.server.01.block.1.52af20de-9a7e-40f5-a9b0-65e191ea5564"
],
"name":"lak.server.01.72.1.dfedd742-66bc-4b3c-b626-01c581d12cc5",
"rpoolid":1,
"replicas":1
}
]
}
],
"volume_groups":[
]
}
],
"clone":"enabled",
"enable_hooklogs":true,
"bundle_path":"\/usr\/local\/robin\/collections\/file-collection-1598641146105\/1598641180179\/centos-1.0",
"robin_version":"5.3.0-172",
"planid":33,
"zoneid":1598666199,
"app_ns":"t001-u000003",
"snapshot":"enabled",
"version":"7",
"name":"lak",
"from_template":null
},
"namespace":"t001-u000003",
"limits":[
{
"vol_type":"data",
"snapshot_space_limit":375809639,
"role":"server"
},
{
"vol_type":"block",
"snapshot_space_limit":375809639,
"role":"server"
}
],
"kind":"robin",
"name":"lak",
"opcode":null
},
"jobid":257
}
10.26. Adding a volume for a service within an application¶
In certain scenarios, users will need to attach an additional volume post application deployment for a service that whose data capcacity needs to be extended. This is commonly done for Oracle RAC where the database might need access to increased storage or the number of volumes accesible for a Hadoop data node might need to be increased. Robin provides a native way in which to do this without any downtime for the respective containers. In order to add a volume, issue the following command:
# robin app addvol <name> <role> <voltype> <size> <mntpath>
|
Application instance name |
|
Name of role to add volume to |
|
Type of additional volume. This must already be predefined within the application bundle. |
|
Size of additional volume |
|
Path on which the additional volume should be mounted |
Example:
# robin app addvol a1 mysql data 3G /var/lib/new --wait
Job: 363 Name: ApplicationAddVolume State: VALIDATED Error: 0
Job: 363 Name: ApplicationAddVolume State: WAITING Error: 0
Job: 363 Name: ApplicationAddVolume State: COMPLETED Error: 0
Attaches an an additional volume post application deployment for a service that whose data capcacity needs to be extended without causing any downtime for the respective containers.
End Point: /api/v3/robin_server/robin_server/apps/<appname>
Method: PUT
URL Parameters: None
Data Parameters:
action: addvol- This mandatory field within the payload specifies that the add volume operation is to be performed.name: <app_name>- This mandatory field within the payload specifies the app to which the volume will be added.role: <role_name>- This mandatory field within the payload specifies the role to which the volume needs to be added.volume: <dict_of_properties>–path: <vol_path>- This mandatory field within the dictionary specifies the path on which the additional volume should be mounted.size: <vol_size>- This mandatory field within the dictionary specifies the size of the volume (in bytes) to be added.type: <vol_type- This mandatory field within the dictionary specifies the type of the volume to be added.
Port: RCM Port (default value is 29442)
Headers:
Authorization: <auth_token>: Authorization token to identify which user is sending the request. The token can be acquired from the login API.
Success Response Code: 202
Error Response Code: 500 (Internal Server Error), 404 (Not Found Error), 401 (Unauthorized Error), 400 (Invalid API Usage Error)
Example Response:
Output
{
"plan":{
"user_id":3,
"tenant_id":1,
"current_user":{
"tenant_id":1,
"username":"robin",
"user_context":"robin",
"namespace":"t001-u000003",
"tenant_role":"superadmin",
"ip_addr":"172.17.0.1",
"user_permissions":{
},
"user_contexts":[
"robin"
],
"user_id":3,
"session_expires":"2020-09-09T00:09:15",
"tenant":"Administrators",
"tenants":[
"Administrators"
],
"user_capabilities":[
"AllSuperAdminCapabilities"
]
},
"action":"addvol",
"role":"server",
"namespace":"t001-u000003",
"volume":{
"snapshot_space_limit":1127428917,
"fstype":"ext4",
"vol_ns":"t001-u000003",
"compression":"disabled",
"snap_reserved":20,
"layout":"round-robin",
"media":"HDD",
"volgrp_name":"lak.server.01.72.1.79604a77-a02e-4293-9e4a-ff5a23bfb74c",
"pvcpolicy":"create",
"encryption":"none",
"replication":1,
"size":3221225472,
"k8s_name":"lak-server-01-data-1-be9e603f",
"disk_tags":{
},
"workload":0,
"protection":0,
"path":"\/var\/lib\/new",
"lvm_vol_count":"0",
"stordriver":{
"faultdomain":"host",
"protection":0,
"media":"HDD",
"type":"das"
},
"faultdomain":"host",
"type":"data",
"lvm_type":"None",
"name":"lak.server.01.data.1.be9e603f-8c52-4472-9aa6-c8a9ada07ae3",
"blocksize":4096
},
"name":"lak",
"kind":"robin",
"opcode":null
},
"jobid":258
}
10.27. Managing Application Vnodes¶
Within Robin, an application is defined to consist of vnodes. A Vnode is a Robin-specific construct that is used to refer to a Pod
in the native Kubernetes world in the majority of cases. The existence of this construct allows users to have more granular control of their
applications as it enables them to manipulate the essential building blocks of their workload. Some of the life-cycle operations that can
be performed at the Vnode level including restarting a Vnode (which translates to destroying and recreating a pod without losing any data
stored within) and relocating a vnode to another host (which translates to moving a pod from one Kubernetes node to another).
In addition to the operations described above, the following commands are described in this section:
|
View all Vnodes |
|
Retrieve information about a particular Vnode |
|
Stop a particular Vnode |
|
Start a particular Vnode |
|
Stop and then start a particular Vnode |
|
Move a Vnode to another host |
|
Repair the storage of a particular Vnode |
Note
The terms vnode and instance are interchangeable and refer to the same underlying construct.
10.27.1. Listing all Vnodes¶
In order to view all Vnodes currently part of Robin applications alongside details such as their status, the host on which they reside and the compute resources allocated to them, issue the following command:
# robin instance list --host <hostname>
--app <app_name>
--all
--json
|
Filter results based on hosts on which instances are located |
|
Filter results based on applications instances are part of |
|
Display deleted instances alongside current instances |
|
Output in JSON format |
Example:
# robin instance list
ID | Owner/Tenant | ResPool | Container | Hostname | IP Addresses | Status | Autopilot | LastOpr | Host | Engine | Cores | GPUs | Mem (GB) | Ctime
---+----------------------+---------+----------------------+-----------------------------------------------------+------------------+--------+-----------+---------+---------------+--------+-------+------+----------+----------------------
6 | robin/Administrators | default | new-app.server.01 | new-app-server-01.t001-u000003.svc.cluster.local | 172.21.31.14/16 | ONLINE | Enabled | STARTED | cscale-82-140 | docker | 1 | 0 | 0.2 | 10 Aug 2020 23:21:59
7 | robin/Administrators | default | new-app-2.server.01 | new-app-2-server-01.t001-u000003.svc.cluster.local | 172.21.22.121/16 | ONLINE | Enabled | STARTED | cscale-82-140 | docker | 1 | 0 | 0.2 | 10 Aug 2020 23:30:52
8 | robin/Administrators | default | new-app-10.server.01 | new-app-10-server-01.t001-u000003.svc.cluster.local | 172.21.25.97/16 | ONLINE | Enabled | STARTED | cscale-82-140 | docker | 1 | 0 | 0.2 | 10 Aug 2020 23:35:23
9 | robin/Administrators | default | demo.server.01 | demo-server-01.t001-u000003.svc.cluster.local | 172.21.23.80/16 | ONLINE | Enabled | STARTED | cscale-82-140 | docker | 1 | 0 | 0.2 | 11 Aug 2020 21:50:03
Returns all Vnodes currently part of Robin applications alongside details such as their status, the host on which they reside and the compute resources allocated to them.
End Point: /api/v5/robin_server/instances
Method: GET
URL Parameters:
appname=<appname>: Utilizing this parameter results in only instances that are part of the specified application being returned.host=<hostname>: Utilizing this parameter results in only instances residing on the specified host being returned.deleted=true: Utilizing this parameter results in deleted instances being returned alongside any existing instances.
Data Parameters: None
Port: RCM Port (default value is 29442)
Headers:
Authorization: <auth_token>: Authorization token to identify which user is sending the request. The token can be acquired from the login API.
Success Response Code: 200
Error Response Code: 500 (Internal Server Error)
Example Response:
Output
{
"users":[
{
"username":"robin",
"lastname":"Systems",
"email":null,
"id":3,
"tenantid":1,
"firstname":"Robin"
}
],
"instances":[
{
"gpu_cores":0,
"rpool":"default",
"cpu_cores":1,
"hugepages_2m":0,
"tenant_ref":1,
"hugepages_1g":0,
"memory":209715200,
"engine":"docker",
"hostname":"new-app-server-01.t001-u000003.svc.cluster.local",
"appcluster_id":6,
"host":"cscale-82-140.robinsystems.com",
"uptime":1597126919,
"user_ref":3,
"state":"STARTED",
"id":6,
"name":"new-app.server.01",
"ctime":1597126919,
"status":"ONLINE",
"autopilot":true
},
{
"gpu_cores":0,
"rpool":"default",
"cpu_cores":1,
"hugepages_2m":0,
"tenant_ref":1,
"hugepages_1g":0,
"memory":209715200,
"engine":"docker",
"hostname":"new-app-2-server-01.t001-u000003.svc.cluster.local",
"appcluster_id":7,
"host":"cscale-82-140.robinsystems.com",
"uptime":1597127452,
"user_ref":3,
"state":"STARTED",
"id":7,
"name":"new-app-2.server.01",
"ctime":1597127452,
"status":"ONLINE",
"autopilot":true
},
{
"gpu_cores":0,
"rpool":"default",
"cpu_cores":1,
"hugepages_2m":0,
"tenant_ref":1,
"hugepages_1g":0,
"memory":209715200,
"engine":"docker",
"hostname":"new-app-10-server-01.t001-u000003.svc.cluster.local",
"appcluster_id":8,
"host":"cscale-82-140.robinsystems.com",
"uptime":1597127723,
"user_ref":3,
"state":"STARTED",
"id":8,
"name":"new-app-10.server.01",
"ctime":1597127723,
"status":"ONLINE",
"autopilot":true
},
{
"gpu_cores":0,
"rpool":"default",
"cpu_cores":1,
"hugepages_2m":0,
"tenant_ref":1,
"hugepages_1g":0,
"memory":209715200,
"engine":"docker",
"hostname":"demo-server-01.t001-u000003.svc.cluster.local",
"appcluster_id":9,
"host":"cscale-82-140.robinsystems.com",
"uptime":1597208647,
"user_ref":3,
"state":"STARTED",
"id":9,
"name":"demo.server.01",
"ctime":1597207803,
"status":"ONLINE",
"autopilot":true
}
],
"ipaddresses":{
"8":[
"172.21.25.97\/16"
],
"9":[
"172.21.23.80\/16"
],
"6":[
"172.21.31.14\/16"
],
"7":[
"172.21.22.121\/16"
]
},
"tenants":[
{
"id":1,
"name":"Administrators"
}
]
}
10.27.2. Show information about a specific Vnode¶
In order to view details about a particular Vnode including information about the compute, storage and networking components of the pod alongside any events concerning it, issue the following command:
# robin instance info <name>
--hooks
--env
--events
--json
|
Name of application instance |
|
Display information about the Vnode’s hook scripts |
|
Display information about the Vnode’s environment variables |
|
Display information about events relating to this Vnode |
|
Output in JSON format |
Example:
# robin instance info demo.server.01
Status:
Name : demo.server.01
Application : demo
Resource Pool : default
Created Time : 11 Aug 2020 21:50:03
State : STARTED
Autopilot : Enabled
Status : ONLINE (Desired: ONLINE)
Physical Host:
Hostname : cscale-82-140.robinsystems.com
Host State : ONLINE
Host Status : 1
Host Compute State : ONLINE
Host Compute Status : READY
Host robin-agent : RUNNING
Host monitor-server : RUNNING
Host iomgr-server : RUNNING
Network:
Hostname : demo-server-01.t001-u000003.svc.cluster.local
IP Address : 172.21.23.80/16
Compute:
Engine : docker
Max_cores : 1
Max_memory : 0.2G
Hugepages-2Mi : -
Hugepages-1Gi : -
Storage : (HDD: 2G, SSD: -)
Id:18 demo.server.01.data.1.424679e5-6aa3-466f-a4a9-8a40b70f3ff6 : HDD 1G (ONLINE)
Id:19 demo.server.01.block.1.1d69df39-84a2-462a-806d-71df0a3aa7cc : HDD 1G (ONLINE)
Bundle:
Bundle Id : 1
Bundle Name : centos
Bundle Version : 1.0
Bundle ObjectId : 1597122985597
Bundle Hooks Path : cscale-82-140.robinsystems.com:/var/lib/robin/file_object_cache/centos-1.0/scripts
Events:
RestartPolicy:
restart_limit : 15
restart_left : 15
burst_interval : 600 seconds
burst_count : N/A
Returns details about a particular Vnode including information about the compute, storage and networking components of the pod alongside its current status.
End Point: /api/v3/robin_server/instances/<instance_name>
Method: GET
URL Parameters: None
Data Parameters: None
Port: RCM Port (default value is 29442)
Headers:
Authorization: <auth_token>: Authorization token to identify which user is sending the request. The token can be acquired from the login API.
Success Response Code: 200
Error Response Code: 500 (Internal Server Error), 404 (Not Found Error), 401 (Unauthorized Error)
Example Response:
Output
{
"state":"Succeed",
"message":"NA",
"items":{
"utime":1597208647,
"rpool":"default",
"memory":209715200,
"capacity":{
"threshold":85,
"unit":"Bytes",
"total":0,
"used":0
},
"physical_host":{
"state":"ONLINE",
"compute_status":"READY",
"compute_services":[
[
"robin-agent",
true
],
[
"monitor-server",
true
],
[
"iomgr-server",
true
]
],
"public_hostname":"cscale-82-140.robinsystems.com",
"status":1,
"public_ip":"10.9.82.140",
"compute_state":"ONLINE",
"hostname":"cscale-82-140.robinsystems.com"
},
"autopilot":true,
"root_fs":"\/usr\/local\/robin\/instances\/demo-server-01.t001-u000003.svc.cluster.local",
"hugepages_1g":0,
"engine":"docker",
"user":"robin",
"config":{
"utime":1597207803,
"vnodehookargs":{
"postcreate":[
]
},
"root_fs":"\/usr\/local\/robin\/instances\/demo-server-01.t001-u000003.svc.cluster.local",
"enable_metrics":true,
"state":"STARTED",
"ctime":1597207803,
"env":{
"DOCKER_OPTS":{
"type":"text",
"value":"-v \/sys\/fs\/cgroup:\/sys\/fs\/cgroup --cap-add=SYS_ADMIN"
},
"ENABLE_SSH":{
"type":"boolean",
"value":true
},
"ROOT_PASSWORD":{
"type":"password",
"value":""
},
"allocated":{
"DOCKER_OPTS":"-v \/sys\/fs\/cgroup:\/sys\/fs\/cgroup --cap-add=SYS_ADMIN",
"ENABLE_SSH":true,
"ROOT_PASSWORD":"",
"POD_NS":"t001-u000003",
"ROBINHOST_TAG_KUBERNETES.IO-OS":"linux",
"ROBINHOST_TAG_KUBERNETES.IO-ARCH":"amd64",
"ROBINHOST":"cscale-82-140.robinsystems.com",
"POD_NAME":"demo-server-01",
"K8S_NODE":"cscale-82-140",
"ROBINHOST_TAG_ROBINRPOOL":"default"
}
},
"allocated_host_type":"physical",
"hosttags":{
"robin.io\/robinrpool":[
"default"
],
"kubernetes.io\/os":[
"linux"
],
"kubernetes.io\/arch":[
"amd64"
]
},
"appname":"demo",
"restart_num":15,
"host_ip":"172.21.23.80",
"hostname":"demo-server-01.t001-u000003.svc.cluster.local",
"image":{
"name":"robinsys\/centos",
"init_mode":false,
"registry_port":"",
"entrypoint":"entry.sh",
"engine":"docker",
"registry_hostname":"",
"version":"7"
},
"storage":[
{
"fstype":"ext4",
"stordriver":{
"faultdomain":"host",
"protection":0,
"type":"das",
"media":"HDD"
},
"k8s_name":"demo-server-01-data-1-424679e5",
"volgrp_name":"demo.server.01.72.1.4567d4ef-ce18-4cec-87b6-d4f204e14eab",
"path":"\/data",
"allocated":{
"block_size":4096,
"stordriver":{
"faultdomain":"host",
"protection":0,
"type":"das",
"media":"HDD"
},
"volumeid":"18",
"partitions":0,
"multinode_mounting":false,
"vtype":0,
"size":1073741824,
"genkey":1597207790284383,
"snapshot_space_limit":214748365,
"protection":0,
"name":"demo.server.01.data.1.424679e5-6aa3-466f-a4a9-8a40b70f3ff6",
"compression":0,
"appname":"default",
"grpid":18,
"priority":2,
"params":{
},
"appid":1,
"media":72,
"replication":1,
"next_snapshotid":2,
"slice_size":1073741824,
"current_snapshotid":1,
"current_snapshot":"active_snap",
"qgroupid":18,
"resource_poolid":1,
"next_backupid":1
},
"lvm_type":"None",
"snap_reserved":20,
"encryption":"none",
"lvm_vol_count":"0",
"device":"\/dev\/sdk",
"blocksize":4096,
"pvcpolicy":"create",
"size":1073741824,
"snapshot_space_limit":214748365,
"name":"demo.server.01.data.1.424679e5-6aa3-466f-a4a9-8a40b70f3ff6",
"vol_ns":"t001-u000003",
"workload":0,
"layout":"round-robin",
"protection":0,
"faultdomain":"host",
"type":"data",
"media":"HDD",
"replication":1,
"disk_tags":{
},
"compression":"disabled"
},
{
"fstype":"raw",
"stordriver":{
"faultdomain":"host",
"protection":0,
"type":"das",
"media":"HDD"
},
"k8s_name":"demo-server-01-block-1-1d69df39",
"volgrp_name":"demo.server.01.72.1.8433e073-8691-4467-afdb-49f61be817b3",
"path":"\/dev\/rda",
"allocated":{
"block_size":4096,
"stordriver":{
"faultdomain":"host",
"protection":0,
"type":"das",
"media":"HDD"
},
"volumeid":"19",
"partitions":0,
"multinode_mounting":false,
"vtype":0,
"size":1073741824,
"genkey":1597207790379086,
"snapshot_space_limit":214748365,
"protection":0,
"name":"demo.server.01.block.1.1d69df39-84a2-462a-806d-71df0a3aa7cc",
"compression":0,
"appname":"default",
"grpid":19,
"priority":2,
"params":{
},
"appid":1,
"media":72,
"replication":1,
"next_snapshotid":2,
"slice_size":1073741824,
"current_snapshotid":1,
"current_snapshot":"active_snap",
"qgroupid":19,
"resource_poolid":1,
"next_backupid":1
},
"lvm_type":"None",
"snap_reserved":20,
"encryption":"none",
"lvm_vol_count":"0",
"device":"\/dev\/sdl",
"blocksize":4096,
"pvcpolicy":"create",
"size":1073741824,
"snapshot_space_limit":214748365,
"name":"demo.server.01.block.1.1d69df39-84a2-462a-806d-71df0a3aa7cc",
"vol_ns":"t001-u000003",
"workload":0,
"layout":"round-robin",
"protection":0,
"faultdomain":"host",
"type":"block",
"media":"HDD",
"replication":1,
"disk_tags":{
},
"compression":"disabled"
}
],
"rpoolid":1,
"allocated_host_public_hostname":"cscale-82-140.robinsystems.com",
"pod_ns":"t001-u000003",
"jobid":90,
"bundle_path":"\/usr\/local\/robin\/collections\/file-collection-1597122699552\/1597122985597\/centos-1.0",
"network":[
{
"name":"robin-default",
"allocated_ip":"172.21.23.80",
"interfaces":1,
"allocated_netmask":"255.255.0.0",
"ippool":"robin-default",
"allocated_names":[
"eth0"
],
"allocated_by":"system",
"driver":"calico",
"allocated_prefix":16,
"subnet":"172.21.0.0"
}
],
"bundleid":1,
"sidecar_info":{
"containers":[
],
"mem":0,
"gpu":0,
"cpu":0,
"hugepages_1g":0,
"hugepages_2m":0
},
"volume_groups":[
{
"device_sets":[
{
"name":"demo.server.01.72.1.4567d4ef-ce18-4cec-87b6-d4f204e14eab.0.717a6eb8-97a6-46b3-b097-9f9532a95762",
"devices":[
{
"max_volumes_per_disk":10,
"tags":{
},
"capacity":107374182400,
"score":90,
"aslices":17,
"slices":77,
"reattachable":0,
"allocated_slices":2,
"state":"READY",
"type":"HDD",
"host":"cscale-82-140.robinsystems.com",
"role":"Storage",
"psize":107374182400,
"stormgr_id":2,
"max_latency_sensitive_vols_per_disk":2,
"hostname":"cscale-82-140.robinsystems.com",
"wwn":"0x600224804c48fd7e16c608dea0919064",
"devpath":"\/dev\/disk\/by-id\/scsi-3600224804c48fd7e16c608dea0919064",
"write_unit":4096,
"pused":369098752,
"protected":0,
"max_throughput_intensive_vols_per_disk":1
}
],
"stormgr_id":18
}
],
"name":"demo.server.01.72.1.4567d4ef-ce18-4cec-87b6-d4f204e14eab",
"rpoolid":1,
"stormgr_id":18,
"replicas":1,
"volumes":[
"demo.server.01.data.1.424679e5-6aa3-466f-a4a9-8a40b70f3ff6"
],
"layout":"round-robin",
"media":"HDD"
},
{
"device_sets":[
{
"name":"demo.server.01.72.1.8433e073-8691-4467-afdb-49f61be817b3.0.9c6285de-48e8-40fc-83c3-1f1e98b86fc1",
"devices":[
{
"max_volumes_per_disk":10,
"tags":{
},
"capacity":107374182400,
"score":90,
"aslices":17,
"slices":77,
"reattachable":0,
"allocated_slices":2,
"state":"READY",
"type":"HDD",
"host":"cscale-82-140.robinsystems.com",
"role":"Storage",
"psize":107374182400,
"stormgr_id":2,
"max_latency_sensitive_vols_per_disk":2,
"hostname":"cscale-82-140.robinsystems.com",
"wwn":"0x600224804c48fd7e16c608dea0919064",
"devpath":"\/dev\/disk\/by-id\/scsi-3600224804c48fd7e16c608dea0919064",
"write_unit":4096,
"pused":369098752,
"protected":0,
"max_throughput_intensive_vols_per_disk":1
}
],
"stormgr_id":19
}
],
"name":"demo.server.01.72.1.8433e073-8691-4467-afdb-49f61be817b3",
"rpoolid":1,
"stormgr_id":19,
"replicas":1,
"volumes":[
"demo.server.01.block.1.1d69df39-84a2-462a-806d-71df0a3aa7cc"
],
"layout":"round-robin",
"media":"HDD"
}
],
"bundle_object_id":"a360b352c8c800e7f1af4075bb3320a4",
"allocated_host_public_ip":"10.9.82.140",
"engine":"docker",
"allocated":{
"zoneid":1597147518,
"zonename":"default",
"nodename":"cscale-82-140",
"nodeid":1
},
"vnodehooks":{
"postcreate":"bash postcreate.sh"
},
"numa_allocations":{
"0":{
"isol_dedicated_cores_used":0,
"non_isol_cores_used":1,
"hugepages_1g_used":0,
"gpu_used":0,
"isol_shared_cores_used":0,
"mem_used":209715200,
"hugepages_2m_used":0
}
},
"gpu":{
"min":0,
"max":0
},
"cpu":{
"min":0,
"max":1,
"reserve":false
},
"role":"server",
"service_uids":[
],
"k8s_provider":"robin",
"desired_status":"ONLINE",
"allocated_host":"cscale-82-140.robinsystems.com",
"name":"demo.server.01",
"enable_hooklogs":true,
"id":9,
"appid":9,
"cm_keys":[
"ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDN8WYsAfs0+a1zzAIWIVV5MrZUaur688E08BL7fm+1uBFjBRPEevwrYrNFL7ebjJxYuB1R3WR+IX8Mmz7CiMDvfEiAQL1Ihj4GZ32WSqzZ7MN15UJK4DQWY7sU++VIusyPUj5goVS2mPj0k4zhheNOlC8XaaHgyUq+NjHHDZF5B4mX7huWfM+kC4u5nCvajoHdfeOse4e1n5RlXtlKRqzBbIma6w8Ej32qFxRLvp4lUXzCylYHBLGH42CKWvtxvETwJUb1kIW9DExSnD+u5fd4Dc2D98\/SY79OO4+aa7GA7JV7412S5kWbtq5cpnkDlvhon\/XzLVQlIqIiAJ6ukVmx root@cscale-82-140"
],
"enable_portmapping":true,
"pod_name":"demo-server-01",
"role_name":"server",
"mem":{
"hugepages_1g":0,
"size":209715200,
"hugepages_2m":0
},
"calico_inuse":true,
"restart_on_qoscfg":true,
"vnodeid":9
},
"tenant":"Administrators",
"state":"STARTED",
"cpu_cores":1,
"ctime":1597207803,
"events":[
],
"role":"server",
"bundle":{
"name":"centos",
"tenants":[
"Administrators"
],
"create_time":"August 10, 2020 22:16:25",
"file_object_id":1597122985597,
"parent":"",
"pathname":"\/usr\/local\/robin\/collections\/file-collection-1597122699552\/1597122985597\/centos-1.0",
"share_with_all_tenants":false,
"ntemplates":1,
"type":"ROBIN",
"user":"robin",
"version":"1.0",
"zoneid":1597147518,
"napps":1,
"description":"-",
"groupid":1,
"collection_id":1597122699552,
"nchildren":1,
"content_id":"a360b352c8c800e7f1af4075bb3320a4",
"tenant":"Administrators",
"bundleid":1
},
"desired_status":"ONLINE",
"name":"demo.server.01",
"image_format":"UNKNOWN",
"volumes":[
{
"name":"demo.server.01.block.1.1d69df39-84a2-462a-806d-71df0a3aa7cc",
"id":"19",
"size":1073741824,
"media":"HDD",
"state":"ONLINE"
},
{
"name":"demo.server.01.data.1.424679e5-6aa3-466f-a4a9-8a40b70f3ff6",
"id":"18",
"size":1073741824,
"media":"HDD",
"state":"ONLINE"
}
],
"ip_addresses":[
"172.21.23.80\/16"
],
"service_ports":null,
"status":"ONLINE",
"id":9,
"hostname":"demo-server-01.t001-u000003.svc.cluster.local",
"gpu_cores":0,
"image":{
"name":"",
"file":"",
"version":""
},
"hugepages_2m":0,
"storage":[
{
"name":"demo.server.01.block.1.1d69df39-84a2-462a-806d-71df0a3aa7cc",
"id":"19",
"size":1073741824,
"media":"HDD",
"state":"ONLINE"
},
{
"name":"demo.server.01.data.1.424679e5-6aa3-466f-a4a9-8a40b70f3ff6",
"id":"18",
"size":1073741824,
"media":"HDD",
"state":"ONLINE"
}
],
"network_bandwidth":null,
"public_ips":[
],
"vnc_port":null,
"restartpolicy":{
"burst_interval":600,
"burst_count":0,
"id":16,
"burst_start_time":0,
"restarts_done":0,
"restart_limit":15
},
"app":"demo",
"distribution":{
"name":"",
"version":""
}
}
}
10.27.3. Stop a Vnode¶
In certain situations, particular Vnodes need to be stopped as they might be in an error state and thus need to be debugged or the resources consumed by it might need to be temporarily released. In order to perform this operation, issue the following command:
# robin instance stop <name>
--force
|
Name of application instance |
|
Ungracefully stop the Vnode without running the respective hook scripts |
Example:
# robin instance stop demo.server.01 --wait
Job: 88 Name: VnodeStop State: PROCESSED Error: 0
Job: 88 Name: VnodeStop State: AGENT_WAIT Error: 0
Job: 88 Name: VnodeStop State: COMPLETED Error: 0
Stops a Vnode in order to help debug error states or to surrender resources consumed by it as they might need to be temporarily released.
End Point: /api/v3/robin_server/instances/<instance_name>
Method: PUT
URL Parameters: None
Data Parameters:
action: stop- This mandatory field within the payload specifies that the stop operation is to be performed.force: true- Utilizing this parameter results in the Vnode being stopped ungracefully without the respective hook scripts being run.
Port: RCM Port (default value is 29442)
Headers:
Authorization: <auth_token>: Authorization token to identify which user is sending the request. The token can be acquired from the login API.
Success Response Code: 202
Error Response Code: 500 (Internal Server Error), 404 (Not Found Error), 401 (Unauthorized Error), 400 (Invalid API Usage Error)
Example Response:
Output
{
"jobid":93
}
10.27.4. Start a Vnode¶
In order to start a Vnode that was previously stopped, issue the following command:
# robin instance start <name>
--host <hostname>
|
Name of application instance |
|
Primary hostname of node on which to start the Vnode on |
Example:
# robin instance start demo.server.01 --wait
Job: 89 Name: VnodeDeploy State: PROCESSED Error: 0
Job: 89 Name: VnodeDeploy State: AGENT_WAIT Error: 0
Job: 89 Name: VnodeDeploy State: COMPLETED Error: 0
Starts a Vnode that was previously stopped.
End Point: /api/v3/robin_server/instances/<instance_name>
Method: PUT
URL Parameters: None
Data Parameters:
action: start- This mandatory field within the payload specifies that the start operation is to be performed.desired_host: <hostname>- Utilizing this parameter, by specifying the primary hostname of a node in the cluster, results in the Vnode being started on the aforementioned host.
Port: RCM Port (default value is 29442)
Headers:
Authorization: <auth_token>: Authorization token to identify which user is sending the request. The token can be acquired from the login API.
Success Response Code: 202
Error Response Code: 500 (Internal Server Error), 404 (Not Found Error), 401 (Unauthorized Error), 400 (Invalid API Usage Error)
Example Response:
Output
{
"jobid":95
}
10.27.5. Restart a Vnode¶
In certain situations, particular Vnodes might need to be restarted in order to solve any errors (such as configuration issues, or entrypoint failures) and allow the Pod to be deployed successfully. In order to perform this operation, issue the following command:
# robin instance restart <name>
--entrypoint <entrypoint>
--host <hostname>
|
Name of application instance |
|
Custom entrypoint command to run in order to help debugging |
|
Primary hostname of node on which to start the Vnode on |
Example:
# robin instance restart demo.server.01 --wait
Job: 90 Name: VnodeDeploy State: PROCESSED Error: 0
Job: 90 Name: VnodeDeploy State: WAITING Error: 0
Job: 90 Name: VnodeDeploy State: AGENT_WAIT Error: 0
Job: 90 Name: VnodeDeploy State: FINALIZED Error: 0
Job: 90 Name: VnodeDeploy State: COMPLETED Error: 0
Restarts Vnodes in order to solve any errors (such as configuration issues, or entrypoint failures) and allow the Pod to be deployed successfully.
End Point: /api/v3/robin_server/instances/<instance_name>
Method: PUT
URL Parameters: None
Data Parameters:
action: restart- This mandatory field within the payload specifies that the restart operation is to be performed.entrypoint: <custom_entrypoint>- Utilizing this parameter, by specifying a custom entrypoint command, results in the Pod’s container being started with the aforementioned entrypoint.desired_host: <hostname>- Utilizing this parameter, by specifying the primary hostname of a node in the cluster, results in the Vnode being started on the aforementioned host.
Port: RCM Port (default value is 29442)
Headers:
Authorization: <auth_token>: Authorization token to identify which user is sending the request. The token can be acquired from the login API.
Success Response Code: 202
Error Response Code: 500 (Internal Server Error), 404 (Not Found Error), 401 (Unauthorized Error), 400 (Invalid API Usage Error)
Example Response:
Output
{
"jobid":99
}
10.27.6. Manually relocating a Vnode¶
In certain scenarios, some instances (pods) of an application might need manual intervention in order to recover. This process might require the pod to be moved to another host which is healthy or more suitable for the resource requirements. In order to relocate an instance, issue the following command:
Note
If no target hostname is specified, Robin’s placement algorithm will attempt to find the best possible target host given the constraints.
# robin instance relocate <name>
--to-host <hostname>
--relax-placement-rules
|
Name of application instance |
|
Primary hostname of target node to relocate the instance to |
|
Relax all placement rules the pod was created with during relocate |
Example:
# robin instance relocate a1.server.01 --wait
Job: 63 Name: VnodeDeploy State: PROCESSED Error: 0
Job: 63 Name: VnodeDeploy State: WAITING Error: 0
Job: 63 Name: VnodeDeploy State: AGENT_WAIT Error: 0
Job: 63 Name: VnodeDeploy State: FINALIZED Error: 0
Job: 63 Name: VnodeDeploy State: COMPLETED Error: 0
Moves a vnode to another host which is healthy or more suitable for the resource requirements.
End Point: /api/v3/robin_server/instances/<instance_name>
Method: PUT
URL Parameters: None
Data Parameters:
action: relocate- This mandatory field within the payload specifies that the relocate operation is to be performed.relax_placement_rules: true- Utilizing this parameter results in all placement rules associated with the Vnode are dropped during the relocate operation.desired_host: <hostname>- Utilizing this parameter, by specifying the primary hostname of a node in the cluster, results in the Vnode being relocated to the aforementioned host.
Port: RCM Port (default value is 29442)
Headers:
Authorization: <auth_token>: Authorization token to identify which user is sending the request. The token can be acquired from the login API.
Success Response Code: 202
Error Response Code: 500 (Internal Server Error), 404 (Not Found Error), 401 (Unauthorized Error), 400 (Invalid API Usage Error)
Example Response:
Output
{
"jobid":103
}
10.27.7. Repairing Vnode storage¶
Certain applications have the ability to automatically recover data which has been corrupted and/or lost even when the underlying data volume are not present. Instances that are created as part of these applications can be repaired which translates to a new data volume being created in place of the faulted volumes with the recovered data in place. In order to perform this operation, issue the following command:
# robin instance repair <name>
--allvol
|
Name of application instance |
|
Replace all the volumes instead of just faulted volumes |
Example:
# robin instance repair demo.server.01 --wait
Job: 92 Name: VnodeDeploy State: PROCESSED Error: 0
Job: 92 Name: VnodeDeploy State: WAITING Error: 0
Job: 92 Name: VnodeDeploy State: AGENT_WAIT Error: 0
Job: 92 Name: VnodeDeploy State: FINALIZED Error: 0
Job: 92 Name: VnodeDeploy State: COMPLETED Error: 0
Repairs a vnode of an application by creating new data volumes to replace the corresponding faulted ones with the recovered data present. Note this operation is only valid for applications that have the ability to automatically recover data which has been corrupted and/or lost even when the underlying data volumes are not present.
End Point: /api/v3/robin_server/instances/<instance_name>
Method: PUT
URL Parameters: None
Data Parameters:
action: repair- This mandatory field within the payload specifies that the repair operation is to be performed.allvol: true- Utilizing this parameter results in all volumes being replaced instead of just the faulted volumes
Port: RCM Port (default value is 29442)
Headers:
Authorization: <auth_token>: Authorization token to identify which user is sending the request. The token can be acquired from the login API.
Success Response Code: 202
Error Response Code: 500 (Internal Server Error), 404 (Not Found Error), 401 (Unauthorized Error), 400 (Invalid API Usage Error)
Example Response:
Output
{
"jobid":109
}
10.28. High Availability of Applications¶
As long as resources are available on surviving nodes, Robin guarantees the high availability of applications in case of server disruptions or downtime and pod failures. As a result, Robin minimizes the application downtime and maximizes the productivity of the end users of the applications. The mechanism through which is this achieved is known as Robin Autopilot. As its name suggests it is a process wherein which no user intervention is needed in order to redeploy an application such that it becomes healthy again. The core concept that drives Autopilot is very simple: maintain a watch over all the application vnodes (pods) in a cluster, and keep track of its current state as well as the desired state – if these do not match, attempt to redeploy or relocate the pod such that it can return to the desired (healthy) state. Since Autopilot only runs on the host where the Robin Server is currently deployed, it utilizes an independent thread that is running on all the nodes in the Robin Cluster to report back the status of the Robin application pods. This thread utilizes the kubelet service to report the state of the pod in Kubernetes back to Autopilot every 5 seconds.
Handling node failures:
Autopilot detects a node failure when the aforementioned independent thread running on a particular node fails to report back within a
given number of seconds; this value is known as the threshold. The default value for this threshold is 50 seconds, and given that Autopilot
polls the monitoring thread every 5 seconds, at least 10 attempts to report the status of the node (and consequently the pods residing on it)
have to fail for Autopilot to consider the node to be down. The delay exists in order to account for network downtime and/or other miscelleanous
reporting errors. In a scenario wherein which this does occur, Autopilot will automatically attempt to relocate the vnodes residing on the failed
host to another suitable host in the cluster. If none of the other exisiting nodes in the cluster are suitable, the application will be marked as
FAULTED and will require manual intervention to recover.
Handling pod failures:
Autopilot detects a pod failure when the monitoring thread running on the host where the pod resides reports that it is unhealthy. Autopilot
then records this state change and marks the appropriate Vnode as FAULTED in Robin. Sticking to the previously described core
principle, this error state does not meet the desired ONLINE status of the Vnode. As a result, Autopilot will automatically attempt to redeploy the
pod on its current host. This is attempted a configurable number of times (by default this value is 15), after which if the pod still is
not running manual intervention is required to recover the pod.
Detecting Pod and Application Health:
Robin supports both standard Kubernetes liveness and readiness probes for Vnodes. They can be defined at the role level within the bundle manifest file. As
result each Vnode (pod) that is deployed for that role will inherit the specified probes. Their structure should be indentical to the one used when specifying
a probe for a standard Kubernetes deployment via a YAML file. These probes in turn will impact the reported state of the pod and consequently determine when
Autopilot attempts to recover the pod. However, in certain scenarios even if all the pods an application is comprised of are healthy, the application itself
might not be functioning correctly. In order to alert the user when such cases occur, Robin allows the user to specify an application health script within the
apphooks section of the bundle manifest. This will be run every 2 minutes as part of a schedule and will allow the user to accurately determine if their
application is truly functional and online.
Note
Since Autopilot only monitors individual Vnodes, it will only take action when it detects the Vnode is in a negative state.
In addition to the above details, the following commands are described in this section:
|
Disable Autopilot |
|
Enable Autopilot |
|
View all objects being tracked by Autopilot |
|
Relocate a Vnode |
10.28.1. Disabling Autopilot¶
Although not generally recommended, one might need to disengage Autopilot in given situations, such as debugging why an application pod is continously crashing. In order to disable Autopilot, issue the following command:
# robin ap disable --app <app_name>
--yes
|
The name of the application to disable Autopilot for |
|
Do not prompt the user for confirmation of disabling |
Example:
# robin ap disable --app a1 --wait --yes
Job: 57 Name: ApplicationUpdate State: PROCESSED Error: 0
Job: 57 Name: ApplicationUpdate State: COMPLETED Error: 0
Disengages autopilot temporarily. Note this is usually not recommended but can be appropriate in certain situations such debugging the continous crashing of application pods.
End Point: /api/v3/robin_server/metrics
Method: PUT
URL Parameters: None
Data Parameters:
method: disable- This mandatory field within the payload specifies that the disable operation is to be performed.
Port: RCM Port (default value is 29442)
Headers:
Authorization: <auth_token>: Authorization token to identify which user is sending the request. The token can be acquired from the login API.
Success Response Code: 200
Error Response Code: 500 (Internal Server Error), 401 (Unauthorized Error), 400 (Invalid API Usage Error)
Example Response: On success the reponse is empty.
10.28.2. Enabling Autopilot¶
Since Autopilot is enabled by default, this command only needs to be run if Autopilot was previously disengaged. By re-enabling Autopilot, the benefits of automatated self-healing and monitoring of applications can be realized. Issue the following command to enable Autopilot:
# robin ap enable --app <app_name>
|
The name of the application to enable Autopilot for |
Example:
# robin ap enable --app a1 --wait
Job: 58 Name: ApplicationUpdate State: PROCESSED Error: 0
Job: 58 Name: ApplicationUpdate State: COMPLETED Error: 0
Rengages Autopilot such that the benefits of automatated self-healing and monitoring of applications can be realized.
End Point: /api/v3/robin_server/metrics
Method: PUT
URL Parameters: None
Data Parameters:
method: enable- This mandatory field within the payload specifies that the enable operation is to be performed.
Port: RCM Port (default value is 29442)
Headers:
Authorization: <auth_token>: Authorization token to identify which user is sending the request. The token can be acquired from the login API.
Success Response Code: 200
Error Response Code: 500 (Internal Server Error), 401 (Unauthorized Error), 400 (Invalid API Usage Error)
Example Response: On success the reponse is empty.
10.28.3. Generating Autopilot Report¶
In order to view all the objects that are currently being tracked by Autopilot and respective details about each assignment such as the threshold value, the last time an update was recieved etc, issue the following command:
# robin ap report --name <name>
--json
|
Object name to filter the report by |
|
Output in JSON |
Example:
# robin ap report
Type | Name | Curr | Desired | LastUpdate | Threshold | MonFreq | GrpName | Autopilot
-----------+------------------------------------------------------------+--------+---------+------------+-----------+---------+--------------------------+-----------
Collection | file-collection-1583356117884 | Online | Online | 5s back | 50 | 5 | vnode36.robinsystems.com | Enabled
Pnode | vnode36.robinsystems.com | Ready | Ready | 5s back | - | 5 | vnode36.robinsystems.com | Enabled
Pnode | vnode88.robinsystems.com | Ready | Ready | 0s back | - | 5 | vnode88.robinsystems.com | Enabled
Pnode | vnode89.robinsystems.com | Ready | Ready | 1s back | - | 5 | vnode89.robinsystems.com | Enabled
Vnode | a1-server-01.t001-u000003.svc.cluster.local (a1.server.01) | ONLINE | ONLINE | 0s back | 50 | 5 | vnode88.robinsystems.com | Enabled
Returns all the objects that are currently being tracked by Autopilot and respective details about each assignment such as the threshold value, the last time an update was recieved etc.
End Point: /api/v3/robin_server/metrics
Method: GET
URL Parameters: None
Data Parameters: None
Port: RCM Port (default value is 29442)
Headers:
Authorization: <auth_token>: Authorization token to identify which user is sending the request. The token can be acquired from the login API.
Success Response Code: 200
Error Response Code: 500 (Internal Server Error) 401 (Unauthorized Error), 400 (Invalid API Usage Error)
Example Response:
Output
{
"items":[
{
"is_in_transition":false,
"desired_status":"Ready",
"last_update_tstamp":1599580075.0771598816,
"monitor_frequency":5,
"name":"cscale-82-140.robinsystems.com",
"status_threshold":null,
"grpname":"cscale-82-140.robinsystems.com",
"prev_attempt_time":0,
"enabled":true,
"create_tstamp":1599238236.5658314228,
"curr_status":"Ready",
"id":"cscale-82-140.robinsystems.com",
"time_elapsed_s":3,
"class":"Pnode",
"backoff_time":0,
"services":{
"gui-cli":{
"Id":"gui-cli",
"ActiveState":"active",
"Type":"simple",
"ExecMainStartTimestamp":"2020-08-28 11:57:19.320496",
"MainPID":2615
},
"sherlock-server":{
"Id":"sherlock-server",
"ActiveState":"inactive",
"Type":"simple",
"ExecMainStartTimestamp":0,
"MainPID":0
},
"robin-node-monitor":{
"Id":"robin-node-monitor",
"ActiveState":"active",
"Type":"simple",
"ExecMainStartTimestamp":"2020-08-28 11:57:01.803506",
"MainPID":1260
},
"robin-watchdog":{
"Id":"robin-watchdog",
"ActiveState":"active",
"Type":"simple",
"ExecMainStartTimestamp":"2020-08-28 11:56:28.105524",
"MainPID":866
},
"httpd":{
"Id":"httpd",
"ActiveState":"active",
"Type":"simple",
"ExecMainStartTimestamp":"2020-08-28 11:57:19.039496",
"MainPID":2583
},
"robin-server":{
"Id":"robin-server",
"ActiveState":"active",
"Type":"simple",
"ExecMainStartTimestamp":"2020-09-04 09:50:28.377093",
"MainPID":52304
},
"robin-event-server":{
"Id":"robin-event-server",
"ActiveState":"active",
"Type":"simple",
"ExecMainStartTimestamp":"2020-08-28 11:56:47.465514",
"MainPID":1037
},
"iomgr-server":{
"Id":"iomgr-server",
"ActiveState":"active",
"Type":"simple",
"ExecMainStartTimestamp":"2020-08-28 11:58:53.276445",
"MainPID":3231
},
"consul_dns":true,
"monitor-server":{
"Id":"monitor-server",
"ActiveState":"active",
"Type":"simple",
"ExecMainStartTimestamp":"2020-08-28 11:57:19.467496",
"MainPID":2655
},
"robin-auth-server":{
"Id":"robin-auth-server",
"ActiveState":"active",
"Type":"simple",
"ExecMainStartTimestamp":"2020-08-28 11:56:42.970516",
"MainPID":1008
},
"robin-file-server":{
"Id":"robin-file-server",
"ActiveState":"active",
"Type":"simple",
"ExecMainStartTimestamp":"2020-08-28 11:56:47.932513",
"MainPID":1075
},
"consul-server":{
"Id":"consul-server",
"ActiveState":"active",
"Type":"simple",
"ExecMainStartTimestamp":"2020-08-28 11:56:23.220527",
"MainPID":569
},
"postgresql-9.6":{
"Id":"postgresql-9.6",
"ActiveState":"active",
"Type":"simple",
"ExecMainStartTimestamp":"2020-08-28 11:56:26.091525",
"MainPID":666
},
"consul-client":{
"Id":"consul-client",
"ActiveState":"inactive",
"Type":"simple",
"ExecMainStartTimestamp":0,
"MainPID":0
},
"robin-agent":{
"Id":"robin-agent",
"ActiveState":"active",
"Type":"simple",
"ExecMainStartTimestamp":"2020-09-03 12:11:21.325069",
"MainPID":2970
},
"stormgr-server":{
"Id":"stormgr-server",
"ActiveState":"active",
"Type":"simple",
"ExecMainStartTimestamp":"2020-08-28 11:57:13.988499",
"MainPID":2273
}
}
},
{
"is_in_transition":false,
"desired_status":"ONLINE",
"last_update_tstamp":1599580075.0771598816,
"monitor_frequency":5,
"name":"lak.server.01",
"status_threshold":50,
"grpname":"cscale-82-140.robinsystems.com",
"prev_attempt_time":1599238236,
"enabled":true,
"create_tstamp":1599238236.5824928284,
"curr_status":"ONLINE",
"id":"lak-server-01.t001-u000003.svc.cluster.local",
"time_elapsed_s":3,
"class":"Vnode",
"backoff_time":10
},
{
"is_in_transition":false,
"desired_status":"ONLINE",
"last_update_tstamp":1599580075.0771598816,
"monitor_frequency":5,
"name":"custom-labels-app.server.01",
"status_threshold":50,
"grpname":"cscale-82-140.robinsystems.com",
"prev_attempt_time":1599238293,
"enabled":true,
"create_tstamp":1599238293.9596076012,
"curr_status":"ONLINE",
"id":"custom-labels-app-server-01.t001-u000003.svc.cluster.local",
"time_elapsed_s":3,
"class":"Vnode",
"backoff_time":10
},
{
"is_in_transition":false,
"desired_status":"ONLINE",
"last_update_tstamp":1599580075.0771598816,
"monitor_frequency":5,
"name":"lak2.server.01",
"status_threshold":50,
"grpname":"cscale-82-140.robinsystems.com",
"prev_attempt_time":1599238236,
"enabled":true,
"create_tstamp":1599238236.5851621628,
"curr_status":"ONLINE",
"id":"lak2-server-01.t001-u000003.svc.cluster.local",
"time_elapsed_s":3,
"class":"Vnode",
"backoff_time":10
},
{
"is_in_transition":false,
"desired_status":"ONLINE",
"last_update_tstamp":1599580075.0771598816,
"monitor_frequency":5,
"name":"lak3.server.01",
"status_threshold":50,
"grpname":"cscale-82-140.robinsystems.com",
"prev_attempt_time":1599238236,
"enabled":true,
"create_tstamp":1599238236.5880100727,
"curr_status":"ONLINE",
"id":"lak3-server-01.t001-u000003.svc.cluster.local",
"time_elapsed_s":3,
"class":"Vnode",
"backoff_time":10
},
{
"is_in_transition":false,
"desired_status":"Online",
"last_update_tstamp":1599580075.0771598816,
"monitor_frequency":5,
"name":"file-collection-1598641146105",
"status_threshold":50,
"grpname":"cscale-82-140.robinsystems.com",
"prev_attempt_time":0,
"enabled":true,
"create_tstamp":1599238236.5969836712,
"curr_status":"Online",
"id":"file-collection-1598641146105",
"time_elapsed_s":3,
"class":"Collection",
"backoff_time":0
}
]
}
10.29. Advanced Application Features¶
Robin provides a variety of advanced features that allows users to take advantage of physical attributes of the nodes on which their application is deployed. These features allow for greater flexibility in terms of deployment, fine-grained control, and enable users to attain maximum performance for their deployments.
10.29.1. Static IP Allocation¶
Robin allows users to assign static IP addresses for bundle applications utilizing either Calico, OVS or SRIOV network driver based IP-Pools. This control enables users to setup complimentary services or infrastructure beforehand, so that they are able to communicate with the application as soon as it is orchestrated and ready. The only prerequisite is that the given IP addresses reside within the respective IP-Pool(s) provided within the application deployment template. This holds true for both range based IP-Pools and those that are defined by a network/netmask combination (also known as a rangeless IP-Pool). One advantage of the latter is that it allows a user to allocate multiple IPv4, IPv6 and dual stack IP Addresses for an application. However, if a given IP Address is already in-use within the Kubernetes cluster the deployment of the application will fail.
In order to specify a particular IP Address for a particular Vnode, its definition within an application JSON will have to be edited such that for each
IP-Pool within the network section from which you want to statically assign an IP Address, an IP Address is specified using the key static_ip.
Example:
{
"roles": [
{
"name": "server",
"vnodes": [
{
"network": [
{
"ippool": "ovs-1",
"static_ip": "10.9.85.144"
},
{
"ippool": "ovs-2",
"static_ip": "fd74:ca9b:3a09:868c:10:9:85:144"
}
]
}
]
}
]
}
Note
For more information on IP-Pool management and creation, please refer to the documentation here.
10.29.2. NUMA Awareness and CPU Exclusivity¶
For latency sensitive workloads, Robin supports deploying applications with NUMA awareness. This means that every Vnode for the application will not cross
the NUMA boundary and as a result all the compute resources requested (including networking) by the Vnode will originate from one NUMA node. This is treated as a strict
constraint and thus if the requirements cannot be met the application deployment will fail altogether. This condition can be specified within the application template
under the application name attribute with the key numa_aware set to True.
Additionally, Robin supports CPU exclusivity at application level - no other application processes will utilize the CPUs assigned by the Robin orchestrator to the original application. This is achieved via CPU pinning and can be further enhanced by isolating CPUs for deployments as part of the node configuration. This is done with every application deployment so no user knowledge (with regards to CPU IDs) or input is needed.
The combination of these two features allows Robin to support highly performant applications with very little manual input from the end user. In addition normal workloads can also be run on the same cluster with no interruption or reduction to the performance of resource intensive applications.
Note
Even without NUMA awareness explicitly requested Robin attempts to make applications as NUMA aware as possible. This means the orchestrator attempts to gather as many of the required resources as possible from one NUMA node. The difference here is - this is a soft requirement and the application deployment will not fail.
10.29.3. Hugepages Support¶
Robin supports the allocation of hugepages to PODs deployed as part of the creation of a Robin bundle application.
The hugepages can be allocated strictly from a single NUMA node if the application needs to be NUMA aware, or can cross
the NUMA boundary depending on the size of the request. As with all other resources, the Robin orchestrator tracks the
consumption of these hugepages across Vnodes deployed within the cluster, and allocates them appropriately. A
custom mount point for the hugepages (other than the default /dev/hugepages) can be specified by the user at the time
of application deployment if need be.
In order to create an application with hugepages one can utilize a variety of methods:
Within the bundle manifest from which the application will be created, the default size of hugepages (1Gi or 2Mi) can be specified for each container of a role. More details can be found here.
At run-time the user can specify the number of hugepages that should be used for each specific role for the application in the UI.
A user can edit the template through which an application will be created to enforce hugepages usage by adding the keys
hugepages_1gorhugepages_2m(and the respective amount of each to be allocated as the values) within the memory requests for each Vnode where it is needed.
10.29.4. Horizontal Pod Auto-scaling¶
The Horizontal Pod Autoscaler (HPA) is a Kubernetes construct that automatically scales the number of pods based on the CPU/Memory usage of an application or any other combination of exposed custom metrics. It is designed to accomodate dynamic changes in an application’s load over time by altering the number of pods such that the average pod utilization or average application response unit remains constant.
Robin leverages the aforementioned Kubernetes HPA infrastructure to enable autoscaling for Robin roles. The HPA configuration for each role can be defined within the manifest file of a Robin Application Bundle and constrained by any metrics scraped by Prometheus. The advantage of this feature is that it provides the granular control needed to scale a particular role/service of an application based on usage. Imagine the following scenario, a role exists that primarily focuses on daily report generation and so could be heavily utilized in the evening but might only receive a handful of requests during the afternoon. In order to efficiently allocate resources, HPA can be utilized to ensure more pods are available when the role’s load increases whilst also releasing resources through the deletion of pods when the role’s utilization falls. Moreover unlike native Kubernetes HPA, Robin allows for application-specific hook scripts to be run before and after the respective scale in and scale-out operations to ensure the service is configured correctly given the adjustments made.
More details on how to enable and configure HPA for an Robin Application Bundle can be found here.
10.29.4.1. Managing an application’s HPA configuration¶
When HPA is configured for a role, Robin disables manual horizontal scaling operations for the respective role since the two features are diametriclly opposed. This is because if there is a manual scale-out operation performed but the role is under utilized the HPA will automatically kick in and reduce the number of pods for that service to original amount. The result is the same for the manual scale-in operation i.e. no change in the total number of pods.
However these manual operations are very useful in certain circumstances and thus Robin provides a command through which HPA can be temporarily disabled for a role so as to allow these commands to be run again. Moreover the same command can be used to alter the minimum/maximum number of pods a role can be manipulated to have via HPA. In order to manage HPA for a particular role of an application as described previously, issue the following command:
# robin app update-hpa <appname> <rolename>
--max-instances <max_instances>
--min-instances <min_instances>
--disable
--enable
|
Application name |
|
Role name |
|
Maximum number of instances that can be spawned for a role via HPA |
|
Minimum number of instances that can be present for a role via HPA |
|
Disable HPA |
|
Enable HPA |
Example:
# robin app update-hpa a1 server --disable --wait
Job: 64 Name: ApplicationUpdateHPA State: PROCESSED Error: 0
Job: 64 Name: ApplicationUpdateHPA State: WAITING Error: 0
Job: 64 Name: ApplicationUpdateHPA State: COMPLETED Error: 0
Enables/disables horizontal pod autoscaling for a particular role within an application. Note when HPA is enabled for the role, manual horizontal scaling operations are disabled.
End Point: /api/v3/robin_server/apps/<app_name>
Method: PUT
URL Parameters: None
Data Parameters:
action: update_hpa- This mandatory field within the payload specifies that the add HPA operation is to be performed.name: <app_name>- This mandatory field within the payload specifies the app for which to configure HPA.role: <role_name>- This mandatory field within the payload specifies the role whose pods will be controlled by the autoscaler.enable_hpa: [true|false]- This mandatory field within the payload specifies whether or not the autoscaler should be enabled or not for the specified role.max_instances: <max_instances_value>- Utilizing this parameter within the payload, by specifying an integer, results in the max number of pods that can be spawned by the autoscaler being set to the value specified. If not specified, the value will be retained from the Kubernetes spec file of the autoscaler.min_instances: <min_instances_value>- Utilizing this parameter within the payload, by specifying an integer, results in the minimum number of pods that can be present when the autoscaler is in control being set to the value specified. If not specified, the value will be retained from the Kubernetes spec file of the autoscaler.
Port: RCM Port (default value is 29442)
Headers:
Authorization: <auth_token>: Authorization token to identify which user is sending the request. The token can be acquired from the login API.
Success Response Code: 202
Error Response Code: 500 (Internal Server Error), 404 (Not Found Error), 401 (Unauthorized Error), 400 (Invalid API Usage Error)
Example Response:
Output
{
"plan": {
"opcode":"None",
"role":"server",
"current_user":{
"tenant":"Administrators",
"user_id":3,
"tenants":[
"t2",
"Administrators"
],
"tenant_id":1,
"user_permissions":{
},
"username":"robin",
"namespace":"random",
"user_context":"robin",
"user_capabilities":[
"AllSuperAdminCapabilities"
],
"ip_addr":"172.17.0.1",
"tenant_role":"superadmin",
"session_expires":"2020-10-15T03:25:40",
"user_contexts":[
"robin",
"robin"
]
},
"kind":"robin",
"max_instances":3,
"name":"demo",
"namespace":"random",
"action":"update_hpa",
"enable_hpa":false
},
"jobid":258
}
10.29.4.2. Considerations for Stateless and Stateful Applications¶
Autoscaling is useful for purely stateless applications where the cost of data redistribution due to scale operations is near zero or minimal, or if the state is in-core and can be very easily rebuilt. Thus workloads such as webservers, REST-endpoints, or stateless business logic applications etc. benefit the most from auto-scaling since they dont suffer from the additional overhead that comes with data replication or movement. However one must exercise caution when considering HPA for stateful applications. This is because not only are they typically data-heavy which introduces the problem of data rebalancing when autoscaling but also there could be a negative impact on the performance of applications running on the same platform due to these operations. The following scenarios expand on these potential issues:
Scenario 1: Let’s say autoscaling is applied to a database which has native scale-out capabilities and a policy set such that an auto scale-out is performed by the application when a certain load average is reached. The following will happen behind the scenes when the average load limit is reached. The HPA will kick in wherein which the first step of the scale-out operation, creating the pods and adding storage volumes is performed (Robin does this in seconds). However for the DB to actually use the resources, the data has to be redistributed (the database does this after Robin executes the post-scale hook). This means that the existing data is read from disk and rebalanced by relocating sections of it from the existing pods to the newly created ones. The moved data is purged from the original pods, which internally also reindexes the existing tables. As a result, the total cost of the data movement (including with the consequent network congestion), the impact on existing clients connected to the database, disk load from reads, writes and reindexing far outweighs the cost of adding more “units” to the database. Moreover, the initial trigger for the scale-out action was high load average which is only increased by the resultant data redistribution from the “relieving” operation. This cyclic dependancy will continously reduce the performance of the database.
Scenario 2: Let’s say the threshold for auto-scaling of our database application is met for non-performance related reasons. As explained above, the cost of the consequent scale-out operation due to the necessary data movement is considerably high but in certain scenarios can be acceptable. However the effect of the operation on other applications running on the same platform must be considered too. Even if the performance penalty incurred for the original application is tolerable the network load caused by the scale-out will negatively affect the performance of other applications using that network or sharing the same server. Moreover, in the worst case the performance threshold of the other applications could be crossed which in turn triggers additional scale-out operations for each of the impacted applications. Thus the load on the overall system is compounded in an expontential manner and ultimately could cause the server to crash.
Given the above reasons, Robin recommends that HPA not be used for stateful applications or if it is necessary under extreme caution and rigourous performance testing.
10.29.4.3. Architecture Diagram¶
The following diagram illustrates the architecture and interaction between different components required to enable HPA for Robin Bundle applications.
