GitHub runner

  • Canonical IS DevOps
Channel Revision Published Runs on
latest/stable 308 11 Dec 2024
Ubuntu 22.04 Ubuntu 20.04
latest/stable 302 02 Dec 2024
Ubuntu 22.04 Ubuntu 20.04
latest/stable 1 09 Feb 2022
Ubuntu 22.04 Ubuntu 20.04
latest/beta 317 11 Dec 2024
Ubuntu 22.04
latest/beta 310 28 Nov 2024
Ubuntu 22.04
latest/edge 322 20 Dec 2024
Ubuntu 22.04 Ubuntu 20.04
latest/edge 310 28 Nov 2024
Ubuntu 22.04 Ubuntu 20.04
latest/edge 4 26 Apr 2022
Ubuntu 22.04 Ubuntu 20.04
local-lxd/stable 306 17 Dec 2024
Ubuntu 22.04
local-lxd/edge 306 27 Nov 2024
Ubuntu 22.04
1/stable 177 05 Jun 2024
Ubuntu 22.04
1/edge 177 05 Jun 2024
Ubuntu 22.04
juju deploy github-runner
Show information

Platform:

Ubuntu
22.04 20.04

How to integrate with COS

This guide demonstrates the process of integrating with the Canonical Observability Stack (COS) using the optional cos-agent integration provided by this charm.

The cos-agent integration can be consumed by the grafana-agent charm, which is responsible for transmitting logs, Prometheus metrics, and Grafana dashboards to the COS stack.

NOTE: The Github Runner charm and grafana-agent charm function as machine charms, while the COS stack comprises Kubernetes charms. Therefore, establishing cross-model integrations is necessary, along with potential firewall rule configurations to allow inter-model traffic.

Requirements

  1. Deploy the Github Runner Charm with the application name github-runner in the machine-model.
  2. Deploy the COS stack on a Kubernetes cloud (refer to this tutorial).
    • Ensure loki, prometheus, grafana, and traefik charms are deployed within a model named k8s-model.
    • Integration between loki and traefik is required to enable grafana-agent to transmit logs by setting a public IP for the Loki service accessible from the machine cloud.
    • Confirm that both models exist in the same Juju controller. If not, adjust the model names by appending the respective controller name (followed by “:”) in the subsequent steps. Ensure you have the necessary permissions to consume the offers.

Steps

  1. Deploy the grafana-agent charm in the machine model.
    juju switch machine-model
    juju deploy grafana-agent --channel latest/edge
    
  2. Integrate the grafana-agent charm with the Github Runner charm.
    juju integrate github-runner grafana-agent
    
  3. Create offers for loki, prometheus, and grafana-agent in the k8s-model.
    juju switch k8s-model
    juju offer loki:logging
    juju offer prometheus:receive-remote-write
    juju offer grafana:grafana-dashboard
    
  4. Consume the offers in the machine model.
    juju switch machine-model
    juju consume loki
    juju consume prometheus
    juju consume grafana
    
  5. Integrate the grafana-agent charm with loki, prometheus, and grafana.
    juju integrate loki-k8s grafana-agent
    juju integrate prometheus-k8s grafana-agent
    juju integrate grafana-k8s grafana-agent
    

You should now be able to access a Grafana Dashboard named GitHub Self-Hosted Runner Metrics, displaying metrics, and another named System Resources exhibiting host resources in Grafana. Additionally, you can explore Loki logs using Grafana’s Explore function. For detailed information about the specific metrics in the GitHub Self-Hosted Runner Metrics dashboard, refer to Metrics.


Help improve this document in the forum (guidelines). Last updated 2 months ago.