{"id":1624,"date":"2023-03-21T21:17:02","date_gmt":"2023-03-21T21:17:02","guid":{"rendered":"https:\/\/community.5gasp.eu\/?page_id=1624"},"modified":"2023-09-26T14:20:31","modified_gmt":"2023-09-26T14:20:31","slug":"juju-charms-tutorial","status":"publish","type":"page","link":"https:\/\/community.5gasp.eu\/index.php\/juju-charms-tutorial\/","title":{"rendered":"Juju Charms tutorial"},"content":{"rendered":"\n
<\/div>\n\n\n\n

Software installation<\/h3>\n\n\n\n

Installation of juju and charmcraft:<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Creation of the Charm structure<\/h3>\n\n\n\n
\"\"<\/figure>\n\n\n\n

<\/p>\n\n\n\n

After running these commands, you should have the following structure:<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Changing files<\/h3>\n\n\n\n

Changing files to create a basic charm<\/p>\n\n\n\n

metadata.yaml<\/strong><\/p>\n\n\n\n

You should replace the maintainer:<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

<\/p>\n\n\n\n

config.yaml<\/strong><\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

<\/p>\n\n\n\n

actions.yaml<\/strong><\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

<\/p>\n\n\n\n

src\/charm.py<\/strong><\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

<\/p>\n\n\n\n

local-config.yaml<\/strong><\/p>\n\n\n\n

Keep in mind that you should replace the hostname with your machine, as well as the username and password that you have.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Notes<\/h2>\n\n\n\n

Before building the charm you might need to execute the following commands:<\/p>\n\n\n\n

$ lxd init --auto\n$ lxc network set lxdbr0 ipv6.address none<\/code><\/pre>\n\n\n\n
Build the charm:<\/p>\n\n\n\n
$ charmcraft build<\/code><\/pre>\n\n\n\n
Before deploying you might need to choose your controller (In your case should be localhost):<\/p>\n\n\n\n
$ juju bootstrap<\/code><\/pre>\n\n\n\n
Deploying the charm using the configurations in the local-config file:<\/p>\n\n\n\n
$ juju deploy .\/prometheus-node-exporter_ubuntu-20.04-amd64.charm --config local-config.yaml<\/code><\/pre>\n\n\n\n
Check status:<\/p>\n\n\n\n
$ juju status<\/code><\/pre>\n\n\n\n
Execute the ‘run<\/strong>‘ action to run a command inside the VM\/VNF. You can check your unit_id<\/em> with juju status.<\/p>\n\n\n\n
$ juju run-action prometheus-node-exporter\/<unit_id> run \"command\"=\"ls -la\" --wait<\/code><\/pre>\n\n\n\n
Adding the Prometheus Node Metrics Exporter’s logic<\/h3>\n\n\n\n
Update actions.yaml<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
<\/p>\n\n\n\n
Update src\/charm.py<\/p>\n\n\n\n
Add needed imports<\/strong><\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
<\/p>\n\n\n\n
Inside the SampleProxyCharm class add the custom actions<\/strong><\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
<\/p>\n\n\n\n
Define the 2 functions inside the class:<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
<\/p>\n\n\n\n
Add functions to handle the prometheus:<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
<\/p>\n\n\n\n
Check if charm is working.<\/p>\n\n\n\n
Build and deploy the charm again<\/strong>.<\/p>\n\n\n\n
First, remove the first charm that we deployed:<\/p>\n\n\n\n
$ juju remove-application prometheus-node-exporter<\/code><\/pre>\n\n\n\n
Using the commands in the first charm, build and deploy.<\/p>\n\n\n\n
Run the action for the prometheus that we created<\/strong>:<\/p>\n\n\n\n
$ juju run-action prometheus-node-exporter\/<unit_id> start-prometheus-exporter --wait<\/code><\/pre>\n\n\n\n
Useful juju commands<\/h2>\n\n\n\n
Delete an application<\/p>\n\n\n\n
$ juju remove-application <application_id><\/code><\/pre>\n\n\n\n
Delete a machine<\/p>\n\n\n\n
$ juju remove-machine <machine_id><\/code><\/pre>\n\n\n\n
Check deployment logs<\/p>\n\n\n\n
$ juju debug-log<\/code><\/pre>\n\n\n\n
Continuously observe deployment status<\/p>\n\n\n\n
$ juju status \u2013watch 5s<\/code><\/pre>\n\n\n\n
Access machine terminal<\/p>\n\n\n\n
$ juju ssh <machine_id><\/code><\/pre>\n\n\n\n
Tutorial materials<\/h2>\n\n\n\n
For a better description of the tutorial, you can check our video here<\/a>.<\/p>\n\n\n\n
You can also check a PDF version of this tutorial here<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"
Software installation Installation of juju and charmcraft: Creation of the Charm structure After running these commands, you should have the following structure: Changing files Changing files to create a basic charm metadata.yaml You should replace the maintainer: config.yaml actions.yaml src\/charm.py local-config.yaml Keep in mind that you should replace the hostname [\u2026]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"pg_page_styles":[],"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"ngg_post_thumbnail":0,"footnotes":""},"class_list":["post-1624","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/community.5gasp.eu\/index.php\/wp-json\/wp\/v2\/pages\/1624","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/community.5gasp.eu\/index.php\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/community.5gasp.eu\/index.php\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/community.5gasp.eu\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/community.5gasp.eu\/index.php\/wp-json\/wp\/v2\/comments?post=1624"}],"version-history":[{"count":8,"href":"https:\/\/community.5gasp.eu\/index.php\/wp-json\/wp\/v2\/pages\/1624\/revisions"}],"predecessor-version":[{"id":1854,"href":"https:\/\/community.5gasp.eu\/index.php\/wp-json\/wp\/v2\/pages\/1624\/revisions\/1854"}],"wp:attachment":[{"href":"https:\/\/community.5gasp.eu\/index.php\/wp-json\/wp\/v2\/media?parent=1624"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}