In this guide, we'll deploy a single-tier web application on Akash. Akash is a permissionless and censorship-resistant cloud network that guarantees sovereignty over your data and your applications. With Akash, you’re in complete control of all aspects of the life cycle of an application with no middleman.
In this guide, we'll setup Lunie Light, a non-custodial, web wallet for Akash on Akash. Lunie Light is a staking interface for proof-of-stake blockchains in the Cosmos ecosystem — built for speed, simplicity, and ease-of-use.
This is a technical guide, best suited to a reader with basic Linux command line knowledge. The audience for this guide is intended for includes:
- Application developers with little or no systems administration experience, wanting to deploy applications on the decentralized cloud.
- System administrators with little or no experience with infrastructure automation, wanting to learn more.
- Infrastructure automation engineers that want to explore decentralized cloud.
- Anyone who wants to get a feel for the current state of the decentralized cloud ecosystem.
You'll need to know information about the network you're connecting your node to. See Choosing a Network for how to obtain any network-related information.
Make sure to have Akash client installed on your workstation, check install guide for instructions.
You'll need an account with funds to pay for your deployment. See the funding guide for creating a key and funding your account.
We will be using shell variables throughout this guide for convenience and clarity. Ensure you have the below set of variables defined on your shell, you can use export VARNAME=...:
| Name | Description |
|---|---|
AKASH_NODE |
Akash network configuration base URL. See here. |
AKASH_CHAIN_ID |
Chain ID of the Akash network connecting to. See here. |
ACCOUNT_ADDRESS |
The address of your account. See here. |
KEY_NAME |
The name of the key you will be deploying from. See here if you haven't yet setup a key |
KEYRING_BACKEND |
Keyring backend to use for local keys. See here |
Verify you have correct $AKASH_NODE, that you have populated while configuring the connection using export AKASH_NODE=$(curl -s "$AKASH_NET/rpc-nodes.txt" | shuf -n 1).
echo $AKASH_NODE $AKASH_CHAIN_ID
http://147.75.195.69:26657 edgenet-4Your values may differ depending on the network you're connecting to, http://147.75.195.69:26657 and edgenet-4 are details for edgenet.
Verify you have the key set up and your account has sufficient balances, see the funding guide otherwise:
My local key is named alice, the below command should return the name you've used:
echo $KEY_NAME
alicePopulate ACCOUNT_ADDRESS from KEY_NAME and verify:
export ACCOUNT_ADDRESS="$(akash keys show $KEY_NAME -a)"
echo $ACCOUNT_ADDRESS
akash1j8s87w3fctz7nlcqtkl5clnc805r240443eksxCheck your account has sufficient balance by running:
akash query bank balances --node $AKASH_NODE $ACCOUNT_ADDRESSYou should see a response similar to:
balances:
- amount: "93000637"
denom: uakt
pagination:
next_key: null
total: "0"
Please note the balance indicated is is denominated in uAKT (AKT 10^-6), in the above example, the account has a balance of 93 AKT*. We're now setup to deploy.
Create a deployment configuration deploy.yml to deploy the ovrclk/lunie-light for Lunie Light Node app container using SDL:
cat > deploy.yml <<EOF
---
version: "2.0"
services:
web:
image: ovrclk/lunie-light
expose:
- port: 3000
as: 80
to:
- global: true
profiles:
compute:
web:
resources:
cpu:
units: 0.1
memory:
size: 512Mi
storage:
size: 512Mi
placement:
westcoast:
attributes:
organization: ovrclk.com
signedBy:
anyOf:
- "akash1vz375dkt0c60annyp6mkzeejfq0qpyevhseu05"
pricing:
web:
denom: uakt
amount: 1000
deployment:
web:
westcoast:
profile: web
count: 1
EOFAlternatively, you can use cURL to download:
curl -s https://raw.githubusercontent.com/ovrclk/docs/master/guides/deploy/deploy.yml > deploy.yml
You may use the sample deployment file as-is or modify it for your own needs as desscribed in our SDL (Stack Definition Language) documentation. A typical modification would be to reference your own image instead of our demo app image.
{% hint style="info" %} Please note if you are running on the testnet, you are limited in the amount of testnet resources you may request. {% endhint %}
To create a deployment, a certificate must first be created. To do this, run:
akash tx cert create client --chain-id $CHAIN_ID --keyring-backend=$KEYRING_BACKEND --from $KEY_NAME --node=$AKASH_NODE
You should see a response similar to:
{
"body": {
"messages": [
{
"@type": "/akash.cert.v1beta1.MsgCreateCertificate",
"owner": "akash1vns5ka3x69ekm3ecp8my8d5zfu8j23p5qew0w3",
"cert": "LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSUJ3RENDQVdXZ0F3SUJBZ0lJRm1pcUJWcWZDVmt3Q2dZSUtvWkl6ajBFQXdJd1NqRTFNRE1HQTFVRUF4TXMKWVd0aGMyZ3hkbTV6Tld0aE0zZzJPV1ZyYlRObFkzQTRiWGs0WkRWNlpuVTRhakl6Y0RWeFpYY3dkek14RVRBUApCZ1ZuZ1FVQ0JoTUdkakF1TUM0eE1CNFhEVEl4TURNd01qSXpNak15TmxvWERUSXlNRE13TWpJek1qTXlObG93ClNqRTFNRE1HQTFVRUF4TXNZV3RoYzJneGRtNXpOV3RoTTNnMk9XVnJiVE5sWTNBNGJYazRaRFY2Wm5VNGFqSXoKY0RWeFpYY3dkek14RVRBUEJnVm5nUVVDQmhNR2RqQXVNQzR4TUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowRApBUWNEUWdBRUtaSTlmWGVPVzRCYXRwcU1mb1VTekx2b01lWGlpbEZTMnJhZlhKdUNObUlMVjJMaWhIZW5JdjJTCjV5Uzh1Zkh5QmNMSUI5aFE1VE81THRHSUpPdzIvYU0xTURNd0RnWURWUjBQQVFIL0JBUURBZ1F3TUJNR0ExVWQKSlFRTU1Bb0dDQ3NHQVFVRkJ3TUNNQXdHQTFVZEV3RUIvd1FDTUFBd0NnWUlLb1pJemowRUF3SURTUUF3UmdJaApBSjJzQ3ZodGNzWkRXUkQ2MU03ZkVCRUk5eEt5Z0UzRkd3K2tIYVhZYXl0TUFpRUE4cUZtb3FEc1Z0ZzhPSHc1Ck5iOEljd0hiNHVkc0RpTzRxaWhoL0owNWZKaz0KLS0tLS1FTkQgQ0VSVElGSUNBVEUtLS0tLQo=",
"pubkey": "LS0tLS1CRUdJTiBFQyBQVUJMSUMgS0VZLS0tLS0KTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFS1pJOWZYZU9XNEJhdHBxTWZvVVN6THZvTWVYaQppbEZTMnJhZlhKdUNObUlMVjJMaWhIZW5JdjJTNXlTOHVmSHlCY0xJQjloUTVUTzVMdEdJSk93Mi9RPT0KLS0tLS1FTkQgRUMgUFVCTElDIEtFWS0tLS0tCg=="
}
],
"memo": "",
"timeout_height": "0",
"extension_options": [],
"non_critical_extension_options": []
},
"auth_info": {
"signer_infos": [],
"fee": {
"amount": [],
"gas_limit": "200000",
"payer": "",
"granter": ""
}
},
"signatures": []
}To deploy on Akash, run:
akash tx deployment create deploy.yml --from $KEY_NAME --node $AKASH_NODE --chain-id $AKASH_CHAIN_ID --keyring-backend $KEYRING_BACKEND -y --fees 5000uaktYou should see a response similar to:
{
"height": "19555",
"txhash": "FC58F52F49E91808A4751E5A5603C34489B253F59E40F7058E1CC5E70F036CA1",
"codespace": "",
"code": 0,
"data": "0A130A116372656174652D6465706C6F796D656E74",
"raw_log": "[{\"events\":[{\"type\":\"akash.v1\",\"attributes\":[{\"key\":\"module\",\"value\":\"deployment\"},{\"key\":\"action\",\"value\":\"deployment-created\"},{\"key\":\"version\",\"value\":\"f2b5e760ca93c53548737d76494db89b08d811f7e9b533aa07fd934bf51d6707\"},{\"key\":\"owner\",\"value\":\"akash1j8s87w3fctz7nlcqtkl5clnc805r240443eksx\"},{\"key\":\"dseq\",\"value\":\"19553\"}]},{\"type\":\"message\",\"attributes\":[{\"key\":\"action\",\"value\":\"create-deployment\"}]}]}]",
"logs": [
{
"msg_index": 0,
"log": "",
"events": [
{
"type": "akash.v1",
"attributes": [
{
"key": "module",
"value": "deployment"
},
{
"key": "action",
"value": "deployment-created"
},
{
"key": "version",
"value": "f2b5e760ca93c53548737d76494db89b08d811f7e9b533aa07fd934bf51d6707"
},
{
"key": "owner",
"value": "akash1j8s87w3fctz7nlcqtkl5clnc805r240443eksx"
},
{
"key": "dseq",
"value": "19553"
}
]
},
{
"type": "message",
"attributes": [
{
"key": "action",
"value": "create-deployment"
}
]
}
]
}
],
"info": "",
"gas_wanted": "200000",
"gas_used": "53806",
"tx": null,
"timestamp": ""
}In this step, you post your deployment, the Akash marketplace matches you with a provider via auction. To create a deployment use akash deployment. The syntax for the deployment is akash tx deployment create <config-path> --from <key-name>.
You can check the status of your lease by running:
akash query market lease list --owner $ACCOUNT_ADDRESS --node $AKASH_NODE --state activeYou should see a response similar to:
- lease_id:
dseq: "19553"
gseq: 1
oseq: 1
owner: akash1j8s87w3fctz7nlcqtkl5clnc805r240443eksx
provider: akash15ql9ycjkkxhpc2nxtnf78qqjguwzz8gc4ue7wl
price:
amount: "186"
denom: uakt
state: active
pagination:
next_key: null
total: "0"
In the above example, we can see that a lease is created using for 186 uakt or 0.00000186 AKT per block to execute the container.
For convenience and clarity for future referencing, we can extract the below set of values to shell variables that we will be using to reference the deployment:
| Attribute | Value |
|---|---|
PROVIDER |
akash15ql9ycjkkxhpc2nxtnf78qqjguwzz8gc4ue7wl |
DSEQ |
19553 |
OSEQ |
1 |
GSEQ |
1 |
Verify we have the right values populated by running:
echo $PROVIDER $DSEQ $OSEQ $GSEQ
akash1ds82uk3pzawavlasc2qd88luewzye2qrcwky7t 19553 1 1Upload the manifest using the values from above step:
akash provider send-manifest deploy.yml --node $AKASH_NODE --dseq $DSEQ --oseq $OSEQ --gseq $GSEQ --owner $ACCOUNT_ADDRESS --provider $PROVIDERYour image is deployed, once you uploaded the manifest. You can retrieve the access details by running the below:
akash provider lease-status --node $AKASH_NODE --dseq $DSEQ --oseq $OSEQ --gseq $GSEQ --provider $PROVIDER --owner $ACCOUNT_ADDRESSYou should see a response similar to:
{
"services": {
"web": {
"name": "web",
"available": 1,
"total": 1,
"uris": [
"6veev7chcfmnclgqklegcc.provider4.akashdev.net"
],
"observed-generation": 0,
"replicas": 0,
"updated-replicas": 0,
"ready-replicas": 0,
"available-replicas": 0
}
},
"forwarded-ports": {}
}You can access the application by visiting the hostnames mapped to your deployment. In above example, its http://6veev7chcfmnclgqklegcc.provider4.akashdev.net
You can view your application logs to debug issues or watch progress like so:
akash \
--home "$AKASH_HOME" \
--node "$AKASH_NODE" \
provider service-logs \
--service $SERVICE_NAME \
--owner "$ACCOUNT_ADDRESS" \
--dseq "$DSEQ" \
--gseq 1 \
--oseq $OSEQ \
--provider "$PROVIDER"where $SERVICE_NAME is the name of a service defined in your SDL.
When you are done with your application, close the deployment. This will deprovision your container and stop the token transfer. This is a critical step to conserve both your tokens and testnet server capacity.
Close deployment using deployment by creating a deployment-close transaction:
akash tx deployment close --node $AKASH_NODE --chain-id $AKASH_CHAIN_ID --dseq $DSEQ --owner $ACCOUNT_ADDRESS --from $KEY_NAME -y
You should see a response simlar to below as a confirmation your deployment is closed:
{
"height": "19913",
"txhash": "C75A7043C002AA5C6BC5562A8330461B57D6C718EB9FD8BCF916F8D50A8AB1EA",
"codespace": "",
"code": 0,
"data": "0A120A10636C6F73652D6465706C6F796D656E74",
"raw_log": "[{\"events\":[{\"type\":\"akash.v1\",\"attributes\":[{\"key\":\"module\",\"value\":\"deployment\"},{\"key\":\"action\",\"value\":\"deployment-updated\"},{\"key\":\"version\",\"value\":\"f2b5e760ca93c53548737d76494db89b08d811f7e9b533aa07fd934bf51d6707\"},{\"key\":\"owner\",\"value\":\"akash1j8s87w3fctz7nlcqtkl5clnc805r240443eksx\"},{\"key\":\"dseq\",\"value\":\"19553\"},{\"key\":\"module\",\"value\":\"deployment\"},{\"key\":\"action\",\"value\":\"deployment-closed\"},{\"key\":\"owner\",\"value\":\"akash1j8s87w3fctz7nlcqtkl5clnc805r240443eksx\"},{\"key\":\"dseq\",\"value\":\"19553\"},{\"key\":\"module\",\"value\":\"market\"},{\"key\":\"action\",\"value\":\"order-closed\"},{\"key\":\"owner\",\"value\":\"akash1j8s87w3fctz7nlcqtkl5clnc805r240443eksx\"},{\"key\":\"dseq\",\"value\":\"19553\"},{\"key\":\"gseq\",\"value\":\"1\"},{\"key\":\"oseq\",\"value\":\"1\"},{\"key\":\"module\",\"value\":\"market\"},{\"key\":\"action\",\"value\":\"bid-closed\"},{\"key\":\"owner\",\"value\":\"akash1j8s87w3fctz7nlcqtkl5clnc805r240443eksx\"},{\"key\":\"dseq\",\"value\":\"19553\"},{\"key\":\"gseq\",\"value\":\"1\"},{\"key\":\"oseq\",\"value\":\"1\"},{\"key\":\"provider\",\"value\":\"akash15ql9ycjkkxhpc2nxtnf78qqjguwzz8gc4ue7wl\"},{\"key\":\"price-denom\",\"value\":\"uakt\"},{\"key\":\"price-amount\",\"value\":\"186\"},{\"key\":\"module\",\"value\":\"market\"},{\"key\":\"action\",\"value\":\"lease-closed\"},{\"key\":\"owner\",\"value\":\"akash1j8s87w3fctz7nlcqtkl5clnc805r240443eksx\"},{\"key\":\"dseq\",\"value\":\"19553\"},{\"key\":\"gseq\",\"value\":\"1\"},{\"key\":\"oseq\",\"value\":\"1\"},{\"key\":\"provider\",\"value\":\"akash15ql9ycjkkxhpc2nxtnf78qqjguwzz8gc4ue7wl\"},{\"key\":\"price-denom\",\"value\":\"uakt\"},{\"key\":\"price-amount\",\"value\":\"186\"}]},{\"type\":\"message\",\"attributes\":[{\"key\":\"action\",\"value\":\"close-deployment\"}]}]}]",
"logs": [
{
"msg_index": 0,
"log": "",
"events": [
{
"type": "akash.v1",
"attributes": [
{
"key": "module",
"value": "deployment"
},
{
"key": "action",
"value": "deployment-updated"
},
{
"key": "version",
"value": "f2b5e760ca93c53548737d76494db89b08d811f7e9b533aa07fd934bf51d6707"
},
{
"key": "owner",
"value": "akash1j8s87w3fctz7nlcqtkl5clnc805r240443eksx"
},
{
"key": "dseq",
"value": "19553"
},
{
"key": "module",
"value": "deployment"
},
{
"key": "action",
"value": "deployment-closed"
},
{
"key": "owner",
"value": "akash1j8s87w3fctz7nlcqtkl5clnc805r240443eksx"
},
{
"key": "dseq",
"value": "19553"
},
{
"key": "module",
"value": "market"
},
{
"key": "action",
"value": "order-closed"
},
{
"key": "owner",
"value": "akash1j8s87w3fctz7nlcqtkl5clnc805r240443eksx"
},
{
"key": "dseq",
"value": "19553"
},
{
"key": "gseq",
"value": "1"
},
{
"key": "oseq",
"value": "1"
},
{
"key": "module",
"value": "market"
},
{
"key": "action",
"value": "bid-closed"
},
{
"key": "owner",
"value": "akash1j8s87w3fctz7nlcqtkl5clnc805r240443eksx"
},
{
"key": "dseq",
"value": "19553"
},
{
"key": "gseq",
"value": "1"
},
{
"key": "oseq",
"value": "1"
},
{
"key": "provider",
"value": "akash15ql9ycjkkxhpc2nxtnf78qqjguwzz8gc4ue7wl"
},
{
"key": "price-denom",
"value": "uakt"
},
{
"key": "price-amount",
"value": "186"
},
{
"key": "module",
"value": "market"
},
{
"key": "action",
"value": "lease-closed"
},
{
"key": "owner",
"value": "akash1j8s87w3fctz7nlcqtkl5clnc805r240443eksx"
},
{
"key": "dseq",
"value": "19553"
},
{
"key": "gseq",
"value": "1"
},
{
"key": "oseq",
"value": "1"
},
{
"key": "provider",
"value": "akash15ql9ycjkkxhpc2nxtnf78qqjguwzz8gc4ue7wl"
},
{
"key": "price-denom",
"value": "uakt"
},
{
"key": "price-amount",
"value": "186"
}
]
},
{
"type": "message",
"attributes": [
{
"key": "action",
"value": "close-deployment"
}
]
}
]
}
],
"info": "",
"gas_wanted": "200000",
"gas_used": "82675",
"tx": null,
"timestamp": ""
}Additionally, you can also query the market to check if your lease is closed:
akash query market lease list --owner $ACCOUNT_ADDRESS --node $AKASH_NODE
You should see a response similar to:
leases:
- lease_id:
dseq: "19553"
gseq: 1
oseq: 1
owner: akash1j8s87w3fctz7nlcqtkl5clnc805r240443eksx
provider: akash15ql9ycjkkxhpc2nxtnf78qqjguwzz8gc4ue7wl
price:
amount: "186"
denom: uakt
state: closed
pagination:
next_key: null
total: "0"
As you can notice from the above, you lease will be marked closed.