Skip to content

docs: improve README#56

Merged
dcoa merged 7 commits intomainfrom
dcoa/readme-improvement
Jun 25, 2024
Merged

docs: improve README#56
dcoa merged 7 commits intomainfrom
dcoa/readme-improvement

Conversation

@dcoa
Copy link
Contributor

@dcoa dcoa commented Jun 6, 2024

This PR has the goal of improving the plugin description throughout the README.

Also, I would like to change the repository description for the current introduction:

Tutor plugin that enables execution of untrusted code in secure sandboxes using an external service based on the codejail library.

JIRA

dcoa and others added 2 commits June 7, 2024 08:08
Co-authored-by: Maria Grimaldi <maria.grimaldi@edunext.co>
Co-authored-by: Maria Grimaldi <maria.grimaldi@edunext.co>
@dcoa dcoa force-pushed the dcoa/readme-improvement branch from 726d6df to 5c6f9a8 Compare June 6, 2024 22:16
README.rst Outdated
tutor plugins enable codejail

Then, you will have to install the "docker-edx-sandbox" apparmor profile on your host:
Install the "docker-edx-sandbox" AppArmor profile on your host:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Install the "docker-edx-sandbox" AppArmor profile on your host:
Run the initialization jobs to install the required AppArmor profile on your host:

The name of the profile changes depending on the python version used by the sandbox (e.g docker-edx-sandbox-3.8.6).

Can we also add a note that the profile must be loaded again if the host is rebooted?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Implemented :)

README.rst Outdated
CODEJAIL_EXTRA_PIP_REQUIREMENTS:
- pybryt

**NOTE:** For some configurations to work, the codejail image must be rebuilt. Command to rebuild codejail: ``tutor images build codejail``.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do we know which configurations merit a new build? Can we add them here?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think most people don't build this image, so it should rather be framed as what would require a custom build:

  1. Additional requirements in the sandbox via CODEJAIL_EXTRA_PIP_REQUIREMENTS.
  2. A different version of python for the sandbox environment via CODEJAIL_SANDBOX_PYTHON_VERSION.
  3. Custom version of edx-platform that changes the contents of requirements/edx-sandbox.

One plugin that includes a section like this is tutor-ecommerce.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Implemented :)

README.rst Outdated
============================

Tutor plugin that enables execution of untrusted code in secure sandboxes using an external `service`_ based on the `codejail`_ library.
Tutor plugin that configures and runs Codejail using a REST API service. Codejail allows for the
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Overall I think is good to go, but if you have time can you include the link to the edunext/codejailservice repository?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sure

@dcoa dcoa force-pushed the dcoa/readme-improvement branch from b3d44df to 2d25f97 Compare June 20, 2024 01:52
@dcoa dcoa merged commit 48988c1 into main Jun 25, 2024
fgosew added a commit to fgosew/tutor-contrib-codejail-sagemath that referenced this pull request Jul 2, 2024
* docs: improve README (eduNEXT#56)

* improve install instructions
* include custom image section
* enhance description

---------

Co-authored-by: Maria Grimaldi <maria.grimaldi@edunext.co>

* feat: redwood support (eduNEXT#54)

Add two new variables to enable the use of custom versions/forks of
`edunext/codejailservice`.

BREAKING CHANGE: the default Python version of the sandbox environment
has been bumped to 3.11. This change alongside the upgrade of the SciPy
and NumPy dependencies may cause some instructor code to fail.

---------

Co-authored-by: Diana Olarte <diana.olarte@edunext.co>
Co-authored-by: Maria Grimaldi <maria.grimaldi@edunext.co>
Co-authored-by: Moisés González <moises.gonzalez@edunext.co>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants