Merge remote-tracking branch 'origin/ISD-2546-readme' into test/opera…

…tor-workflow-change

.github/workflows/integration_test.yaml

@@ -10,4 +10,6 @@ jobs:
     with:
       setup-devstack-swift: true
       trivy-image-config: "trivy.yaml"
+      juju-channel: 3/stable
+      channel: 1.29-strict/stable
       extra-arguments: "--openstack-rc=${GITHUB_WORKSPACE}/openrc"

.licenserc.yaml

@@ -19,6 +19,7 @@ header:
     - '.flake8'
     - '.jujuignore'
     - '.gitignore'
+    - '.trivyignore'
     - '.licenserc.yaml'
     - 'CODEOWNERS'
     - 'icon.svg'

.trivyignore

@@ -0,0 +1,25 @@
+CVE-2023-24538
+CVE-2023-24540
+CVE-2024-24790
+CVE-2022-27664
+CVE-2022-2879
+CVE-2022-2880
+CVE-2022-32190
+CVE-2022-41715
+CVE-2022-41716
+CVE-2022-41720
+CVE-2022-41722
+CVE-2022-41723
+CVE-2022-41724
+CVE-2022-41725
+CVE-2023-24534
+CVE-2023-24536
+CVE-2023-24537
+CVE-2023-24539
+CVE-2023-29400
+CVE-2023-29403
+CVE-2023-39325
+CVE-2023-45283
+CVE-2023-45287
+CVE-2023-45288
+CVE-2024-34156

README.md

@@ -5,16 +5,15 @@
 
 # Content Cache Operator
 
-A Juju charm for deploying and managing a content cache.
+A [Juju](https://juju.is/) [charm](https://juju.is/docs/olm/charmed-operators) deploying and managing service for caching content on Kubernetes, built on top of [Nginx](https://www.nginx.com/), configurable to cache any http or https web site and useful for building Content Delivery Networks (CDN).
 
-## Overview
-
-A service for caching content, built on top of [Nginx](https://www.nginx.com/),
-configurable to cache any http or https web site. Tuning options include
-cache storage size, maximum request size to cache and cache validity duration.
+Like any Juju charm, this charm supports one-line deployment, configuration, integration, scaling, and more. For Charmed Content Cache, this includes:
+* scaling the number of cache instances
+* cache configuration changes
+* deployment on many different Kubernetes platforms, from MicroK8s to Charmed Kubernetes and public cloud Kubernetes offerings
 
 This service was developed to provide front-end caching for web sites run by
-Canonical's IS team, and to reduce the need for third-party CDNs by providing
+Canonical's IS (Infrastructure Services) team, and to reduce the need for third-party CDNs by providing
 high-bandwidth access to web sites via this caching front-end. Currently used
 for a number of services including [the Snap Store](https://snapcraft.io/store),
 the majority of Canonical's web properties including [ubuntu.com](https://ubuntu.com) and
@@ -24,17 +23,55 @@ This Kubernetes-based version is built using the same approach as the [machine c
 a situation where your Kubernetes cluster and its ingress controllers have
 a fast connection to the Internet.
 
+For information about how to deploy, integrate, and manage this charm, see the Official [Content Cache Documentation](https://charmhub.io/content-cache-k8s/docs).
+
+## Get started
+
+To begin, refer to the [Content Cache tutorial](https://charmhub.io/content-cache-k8s/docs/tutorial-getting-started) for step-by-step instructions.
+
+### Basic operations
+
+The following actions are available for the charm:
+- report-visits-by-ip
+
+Tuning options include:
+- cache storage size 
+- maximum request size to cache 
+- cache validity duration
+
+You can find more information about supported actions in [the Charmhub documentation](https://charmhub.io/content-cache-k8s/actions).
+
+## Integrations
+
+Content-cache is meant to serve as cache for another charm. You can use Wordpress as an example:
+
+```
+juju deploy content-cache-k8s
+juju deploy wordpress-k8s
+juju deploy mysql-k8s --trust
+
+juju integrate wordpress-k8s mysql-k8s:database
+juju integrate content-cache-k8s:nginx-proxy wordpress-k8s
+```
+
+Apart from this integration, the charm can be integrated with other Juju charms and services as well. You can find the full list of integrations in [the Charmhub documentation](https://charmhub.io/content-cache-k8s/integrations).
+
+
+## Learn more
+
+- [Read more](https://charmhub.io/content-cache-k8s/docs)
+- [Developer documentation](https://nginx.org/en/docs/dev/development_guide.html)
+- [Official webpage](https://www.nginx.com/)
+- [Troubleshooting](https://matrix.to/#/#charmhub-charmdev:ubuntu.com)
+
+
 ## Project and community
 
-The Content-cache-k8s Operator is a member of the Ubuntu family. It's an
+The Content-cache-k8s Operator is a member of the Ubuntu family. It is an
 open source project that warmly welcomes community projects, contributions,
 suggestions, fixes and constructive feedback.
 * [Code of conduct](https://ubuntu.com/community/code-of-conduct)
 * [Get support](https://discourse.charmhub.io/)
-* [Join our online chat](https://chat.charmhub.io/charmhub/channels/charm-dev)
-* [Contribute](https://charmhub.io/content-cache-k8s/docs/how-to-guides-contributing)
-Thinking about using the Content-cache-k8s for your next project? [Get in touch](https://chat.charmhub.io/charmhub/channels/charm-dev)!
-
----
-
-For further details, [see the charm's detailed documentation](https://charmhub.io/content-cache-k8s/docs)
+* [Contribute](https://charmhub.io/content-cache-k8s/docs/how-to-contribute)
+* [Issues](https://github.com/canonical/content-cache-k8s-operator/issues)
+* [Matrix](https://matrix.to/#/#charmhub-charmdev:ubuntu.com)

charmcraft.yaml

@@ -11,5 +11,21 @@ bases:
         channel: "22.04"
 parts:
   charm:
-    prime: 
+    plugin: charm
+    source: .
+    build-snaps:
+      - rustup
+    override-build: |
+      rustup default stable
+      craftctl default
+    build-packages:
+      - libffi-dev
+      - libssl-dev
+      - pkg-config
+  rock_data:
+    plugin: dump
+    source: .
+    prime:
       - content-cache_rock/nginx_cfg.tmpl
+
+

tests/integration/conftest.py

@@ -43,6 +43,7 @@ async def _run_action(application_name: str, action_name: str, **params):
         Returns:
             The results of the executed action
         """
+        assert ops_test.model
         application = ops_test.model.applications[application_name]
         action = await application.units[0].run_action(action_name, **params)
         await action.wait()
@@ -143,6 +144,7 @@ async def app(
         channel="beta",
         config={"src-overwrite": json.dumps(any_charm_src_overwrite)},
     )
+    await ops_test.model.wait_for_idle(timeout=600)
     await run_action(any_app_name, "rpc", method="start_server")
     await ops_test.model.wait_for_idle()
 

tox.ini

@@ -108,8 +108,8 @@ deps =
     pytest
     pytest-cov
     pytest-operator
-    # Last compatible version with Juju 2.9
-    juju==3.0.4
+    websockets<14.0 # https://github.com/juju/python-libjuju/issues/1184
+    juju
     -r{toxinidir}/requirements.txt
     -r{toxinidir}/tests/integration/requirements.txt
 commands =