Add initial flask app

.github/workflows/integration_test.yaml

@@ -8,13 +8,5 @@ jobs:
     uses: canonical/operator-workflows/.github/workflows/integration_test.yaml@main
     secrets: inherit
     with:
-      load-test-enabled: false
-      load-test-run-args: "-e LOAD_TEST_HOST=localhost"
-      zap-before-command: "curl -H \"Host: indico.local\" http://localhost/bootstrap --data-raw 'csrf_token=00000000-0000-0000-0000-000000000000&first_name=admin&last_name=admin&email=admin%40admin.com&username=admin&password=lunarlobster&confirm_password=lunarlobster&affiliation=Canonical'"
-      zap-enabled: true
-      zap-cmd-options: '-T 60 -z "-addoninstall jython" --hook "/zap/wrk/tests/zap/hook.py"'
-      zap-target: localhost
-      zap-target-port: 80
-      zap-rules-file-name: "zap_rules.tsv"
-      trivy-fs-enabled: true
-      trivy-image-config: "trivy.yaml"
+      self-hosted-runner: true
+      self-hosted-runner-label: "edge"

.github/workflows/test.yaml

@@ -7,3 +7,6 @@ jobs:
   unit-tests:
     uses: canonical/operator-workflows/.github/workflows/test.yaml@main
     secrets: inherit
+    with:
+      self-hosted-runner: true
+      self-hosted-runner-label: "edge"

CONTRIBUTING.md

@@ -9,6 +9,15 @@ tox devenv -e integration
 source venv/bin/activate
 ```
 
+## Generating src docs for every commit
+
+Run the following command:
+
+```bash
+echo -e "tox -e src-docs\ngit add src-docs\n" >> .git/hooks/pre-commit
+chmod +x .git/hooks/pre-commit
+```
+
 ## Testing
 
 This project uses `tox` for managing test environments. There are some pre-configured environments
@@ -22,6 +31,17 @@ tox run -e integration   # integration tests
 tox                      # runs 'format', 'lint', and 'unit' environments
 ```
 
+
+## Development server
+
+Flask contains a development server that can be used to test the charm. To start the server, run:
+
+```shell
+  python -m src.app
+```
+in your virtual environment and project root.
+
+
 ## Build the charm
 
 Build the charm in this git repository using:

README.md

@@ -8,19 +8,19 @@ Avoid using this README file for information that is maintained or published els
 Use links instead.
 -->
 
-# is-charms-template
+# github-runner-webhook-router
 
-Charmhub package name: operator-template
-More information: https://charmhub.io/is-charms-template
+> **Warning**
+Work in progress: This charm is not yet ready for use.
+
+The github-runner-webhook-router charm is a Juju charm that provides a webhook router for GitHub Actions self-hosted runners. 
+This charm is designed to be used in conjunction with the [github-runner-operator](https://github.com/canonical/github-runner-operator) charm.
 
-Describe your charm in one or two sentences.
 
 ## Other resources
 
 <!-- If your charm is documented somewhere else other than Charmhub, provide a link separately. -->
 
-- [Read more](https://example.com)
-
 - [Contributing](CONTRIBUTING.md) <!-- or link to other contribution documentation -->
 
 - See the [Juju SDK documentation](https://juju.is/docs/sdk) for more information about developing and improving charms.

requirements.txt

@@ -1 +1 @@
-ops >= 2.2.0
+Flask == 3.0.2

src-docs/app.py.md

@@ -0,0 +1,45 @@
+<!-- markdownlint-disable -->
+
+<a href="../src/app.py#L0"><img align="right" style="float:right;" src="https://img.shields.io/badge/-source-cccccc?style=flat-square"></a>
+
+# <kbd>module</kbd> `app.py`
+Flask application which receives GitHub webhooks and logs those. 
+
+
+---
+
+<a href="../src/app.py#L22"><img align="right" style="float:right;" src="https://img.shields.io/badge/-source-cccccc?style=flat-square"></a>
+
+## <kbd>function</kbd> `setup_logger`
+
+```python
+setup_logger(log_file: Path) → None
+```
+
+Set up the webhook logger to log to a file. 
+
+
+
+**Args:**
+
+ - <b>`log_file`</b>:  The log file. 
+
+
+---
+
+<a href="../src/app.py#L50"><img align="right" style="float:right;" src="https://img.shields.io/badge/-source-cccccc?style=flat-square"></a>
+
+## <kbd>function</kbd> `handle_github_webhook`
+
+```python
+handle_github_webhook() → tuple[str, int]
+```
+
+Receive a GitHub webhook and append the payload to a file. 
+
+
+
+**Returns:**
+  A tuple containing an empty string and 200 status code. 
+
+

src/app.py

@@ -0,0 +1,67 @@
+# Copyright 2024 Canonical Ltd.
+# See LICENSE file for licensing details.
+
+"""Flask application which receives GitHub webhooks and logs those."""
+
+import json
+import logging
+import os
+import sys
+from datetime import datetime
+from pathlib import Path
+
+from flask import Flask, request
+
+app = Flask(__name__)
+app.config.from_prefixed_env()
+
+
+webhook_logger = logging.getLogger("webhook_logger")
+
+
+def setup_logger(log_file: Path) -> None:
+    """Set up the webhook logger to log to a file.
+
+    Args:
+        log_file: The log file.
+    """
+    webhook_logger.handlers.clear()
+    fhandler = logging.FileHandler(log_file, delay=True)
+    fhandler.setLevel(logging.INFO)
+    webhook_logger.addHandler(fhandler)
+    webhook_logger.setLevel(logging.INFO)
+
+
+def _log_filename() -> str:
+    """Create the log file name.
+
+    Returns:
+        The log file name.
+    """
+    # We use a unique name to avoid race conditions between multiple instances of the app.
+    pid = os.getpid()
+    return datetime.now().strftime(f"webhooks.%Y-%m-%d-%H-%M-%S.{pid}.log")
+
+
+webhook_logs_dir = Path(os.environ.get("WEBHOOK_LOGS_DIR", "/var/log/whrouter"))
+setup_logger(log_file=webhook_logs_dir / _log_filename())
+
+
+@app.route("/webhook", methods=["POST"])
+def handle_github_webhook() -> tuple[str, int]:
+    """Receive a GitHub webhook and append the payload to a file.
+
+    Returns:
+        A tuple containing an empty string and 200 status code.
+    """
+    payload = request.get_json()
+    app.logger.debug("Received webhook: %s", payload)
+    webhook_logger.log(logging.INFO, json.dumps(payload))
+    return "", 200
+
+
+if __name__ == "__main__":
+    # Start development server
+    app.logger.addHandler(logging.StreamHandler(sys.stdout))
+    app.logger.setLevel(logging.DEBUG)
+    app.run()