Skip to main content

Resource Management

caution

The Ash Console is currently in beta and not production-ready. It is under active development and subject to breaking changes.

Resources are the core feature of the Ash Console. They are the building blocks of your infrastructure, deployed in cloud regions of your cloud account/subscription/project and managed by Ash.

info

The Ash Console alpha supports AvalancheNode resources.

note

Resources live under a project and a cloud region. To manage resources, you need to have at least one project and one cloud region.

See Project Management and Cloud Region Management.

Types of resources​

There are several types of resources. See Resource for more information.

List resources​

From the Ash Console project overview page, navigate to the Ressources tab:

Ash Console resource list

Create a resource​

Each resource type has specific requirements, e.g. a nodeId secret is required to create an AvalancheNode resource.

Resource specific requirements
AvalancheNode
{
  "name": "my-avalanche-node",
  "resourceType": "avalancheNode",
  "cloudRegionId": "ff69b281-917e-4ebb-b1e0-f5dc1da297fa",
  "nodeIdSecretId": "4cc8f792-83af-475d-8be0-20c35efc1bd4",
  "size": "small",
  "nodeConfig": {
    "isBootstrapNode": true,
    "avalancheNodeConfig": {
      "avalanchego_version": "1.10.10"
    }
  }
}

You can pass any variable available in the ash.avalanche.node role under nodeConfig.avalancheNodeConfig.

tip

You can provide the secrets' or cloud regions' names instead of their IDs.

From the Ash Console project overview page, navigate to the Ressources tab:

  • Click on the Create Node(s) button.
  • Configure the node as needed
  • Click on the Create button.

Ash Console resource create

Note: See Resource sizes for a list of available resource sizes.

Get a resource and its status​

A resource can be in one of the following statuses:

  • pending: the resource is pending for a machine to be allocated in the cloud region
  • configuring: the resource is being configured
  • running: the resource is running
  • stopped: the resource is stopped
  • error: the resource is in an error state
  • destroying: the resource is being destroyed
tip

You can also provide the resource name instead of its ID.

From the Ash Console project overview page, navigate to the Ressources tab and click on a Resource:

Ash Console resource

Update a resource​

info

For some resource types, updates will not take effect until the resource is restarted. See Restart a resource.

From the Ash Console project overview page, navigate to the Ressources tab and click on a Resource:

Change the resource properties as needed and click on the Update button.

Ash Console resource update

Restart a resource​

Restarting a resource will apply any pending configuration changes and is required if the resource has "restartRequired": true in its status.

caution

Restarting a resource will interrupt its service for a few seconds/minutes.

From the Ash Console project overview page, navigate to the Ressources tab and click on a Resource:

Ash Console resource restart

You can then click on the Restart button.

Delete a resource​

info

Removing a resource is not instantaneous. The resource will be in status destroying for a few seconds/minutes before it is completely removed.

From the Ash Console project overview page, navigate to the Ressources tab and click on a Resource:

Ash Console resource delete

You can then click on the Delete button.

Resource sizes​

The size property of a resource is used to determine the machine type to use. The available sizes depend on the cloud provider.

Here are the available sizes per resource type and their corresponding machine types in each cloud provider:

AvalancheNode​

SizeRAMCPUDiskAzure VM typeAWS EC2 instance typeGCP machine type
small1-2GB1-28-32 (OS) + 50 GiB (resource storage)Standard_B1mst2.smalle2-small
medium8GB48-32 (OS) + 200 GiB (resource storage)Standard_F4sc5.xlargec2d-highcpu-4
large16GB88-32 (OS) + 1000 GiB (resource storage)Standard_F8sc5.2xlargec2d-highcpu-8

SSH to a resource​

Accessing a resource created via the Ash Console can be useful in-depth debugging and additional configuration. Follow the insctructions below to learn how to SSH into a resource.

On the AWS Console:

  • Navigate to EC2.
  • Click on a machine to access its details, resources created by the Ash Console should follow the juju-cr-x-machine-x name pattern.
  • Click on the Connect button to open an in-browser SSH session.

AWS Console SSH

tip

Add your SSH public key to /home/ubuntu/.ssh/authorized_keys to SSH without having to go through the Azure Portal.