Skip to content
Snippets Groups Projects

Iam group change

Merged Carmelo Pellegrino requested to merge iam-group-change into master
All threads resolved!
Files
2
@@ -190,3 +190,41 @@ On successful completion ("CREATE_COMPLETE"),
:alt: Step 4
Use the reported IP address to connect to the services you deployed.
How to change the authorized IAM group
======================================
If you deployed an instance of JupyterHub with persistence of Notebooks and
want to change the name of the IAM group that users must be members of to have
access granted, you need to update the file located in
``/usr/local/share/dodasts/jupyterhub/compose.yaml``. Here is an example of its
content:
.. code-block:: yaml
version: "3.9"
services:
jupyterhub:
depends_on:
- http_proxy
[...]
environment:
- [...]
- OAUTH_GROUPS=users/example admins/example
- ADMIN_OAUTH_GROUPS=admins/example
- [...]
In the example, the ``OAUTH_GROUPS`` environment variable is used to define the
IAM groups of users that granted user-role access within the JupyterHub
instance, while the ``ADMIN_OAUTH_GROUPS`` environment variable defines the IAM
group of users with admin-role access. Multiple groups can be defined,
separated by a space `` `` character.
Furthermore, to make the change effective, a restart of the service has to be
performed:
.. code-block:: bash
cd /usr/local/share/dodasts/jupyterhub/
docker-compose down || docker compose down
docker-compose up -d || docker compose up -d
Loading