Skip to content

Commit

Permalink
feat: I'm fruiiiiiiit
Browse files Browse the repository at this point in the history
  • Loading branch information
regisb committed May 16, 2023
1 parent 31adec4 commit 240cfd0
Show file tree
Hide file tree
Showing 3 changed files with 14 additions and 12 deletions.
5 changes: 4 additions & 1 deletion .gitlab-ci.yml
Original file line number Diff line number Diff line change
@@ -1,8 +1,11 @@
variables:
TUTOR_PLUGIN: cairn
TUTOR_IMAGES: cairn-clickhouse cairn-superset
TUTOR_PYPI_PRIVATE_PACKAGE: tutor-cairn
# TODO uncomment to publish package on pypi
# TUTOR_PYPI_PACKAGE: tutor-cairn
OPENEDX_RELEASE: olive
GITHUB_REPO: overhangio/tutor-cairn


include:
- project: 'community/tutor-ci'
Expand Down
19 changes: 9 additions & 10 deletions README.rst
Original file line number Diff line number Diff line change
Expand Up @@ -43,9 +43,9 @@ Cairn uses the same collect/store/expose paradigm made popular by other framewor
Installation
------------

Cairn requires a `Tutor Wizard Edition license <https://overhang.io/tutor/wizardedition>`__. Once you have enabled your license, installing the plugin is as simple as running::
Cairn used to be a commercial plugin, but is now available for free to all Tutor users. Install the plugin with::

tutor license install tutor-cairn
pip install tutor-cairn

Usage
-----
Expand Down Expand Up @@ -79,11 +79,11 @@ You can then access the frontend with the user credentials you just created. Ope

Some event data might be missing from your dashboards: just start using your LMS and refresh your dashboard. The new events should appear immediately.

.. image:: https://overhang.io/static/catalog/img/cairn/courseoverview-01.png
.. image:: https://raw.githubusercontent.com/overhangio/tutor-cairn/master/static/screenshots/courseoverview-01.png
:alt: Course overview dashboard part 1
.. image:: https://overhang.io/static/catalog/img/cairn/courseoverview-02.png
.. image:: https://raw.githubusercontent.com/overhangio/tutor-cairn/master/static/screenshots/courseoverview-02.png
:alt: Course overview dashboard part 2
.. image:: https://overhang.io/static/catalog/img/cairn/courseoverview-03.png
.. image:: https://raw.githubusercontent.com/overhangio/tutor-cairn/master/static/screenshots/courseoverview-03.png
:alt: Course overview dashboard part 3

Available metrics
Expand Down Expand Up @@ -140,7 +140,7 @@ Or, if you want to avoid running the full plugin initialization::
Running on Kubernetes
~~~~~~~~~~~~~~~~~~~~~

When running on Kubernetes instead of locally, most commands above can be re-written with `tutor k8s exec service "command"` instead of `tutor local run service command`. For instance::
When running on Kubernetes instead of locally, most commands above can be re-written with ``tutor k8s exec service "command"`` instead of ``tutor local run service command``. For instance::

# Privileged user creation
tutor k8s exec cairn-superset "superset fab create-admin --username YOURUSERNAME --email [email protected]"
Expand Down Expand Up @@ -232,11 +232,10 @@ Postgresql/Superset settings
- ``CAIRN_POSTGRESQL_PASSWORD`` (default: ``"{{ 20|random_string }}"``): Postgresql password.
- ``CAIRN_SUPERSET_SECRET_KEY`` (default: ``"{{ 20|random_string }}"``): randomly-generated secret key for the Superset frontend.

Troubleshooting
---------------

Support
-------

Are you having trouble with Cairn? Do you have questions about this plugin? Please get in touch with us at [email protected]. Community support is also available on the official Tutor forums: https://discuss.overhang.io
This Tutor plugin is maintained by Régis Behmo from `Overhang.IO <https://overhang.io>`__. Community support is available from the official `Open edX forum <https://discuss.openedx.org>`__. Do you need help with this plugin? See the `troubleshooting <https://docs.tutor.overhang.io/troubleshooting.html>`__ section from the Tutor documentation.

License
-------
Expand Down
2 changes: 1 addition & 1 deletion setup.py
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ def load_about():
},
license="AGPLv3",
author="Overhang.IO",
description="cairn plugin for Tutor",
description="Scalable, real-time analytics for Open edX",
long_description=load_readme(),
packages=find_packages(exclude=["tests*"]),
include_package_data=True,
Expand Down

0 comments on commit 240cfd0

Please sign in to comment.