diff --git a/.github/workflows/mkdocs-test.yml b/.github/workflows/mkdocs-test.yml index a3ac88325..b8a8b15f8 100644 --- a/.github/workflows/mkdocs-test.yml +++ b/.github/workflows/mkdocs-test.yml @@ -67,8 +67,13 @@ jobs: mkdocs serve > /dev/null 2>&1 & SERVER_PID=$! echo "mk server in PID $SERVER_PID" - # Give enough time for deployment - sleep 30 + # Give enough time for deployment (2min max) + for run in {1..120}; do + if curl --output /dev/null --silent --head --fail http://127.0.0.1:8000/; then + break + fi + sleep 1 + done echo "Launching linkchecker" linkchecker --no-warnings --no-status http://127.0.0.1:8000/ @@ -81,4 +86,4 @@ jobs: git config --global user.email mike@docs.hopsworks.ai - name: Generate the docs with mike - run: mike deploy 3.2-SNAPSHOT dev -u + run: mike deploy test-version diff --git a/README.md b/README.md index be706f7e8..d3ea2d032 100644 --- a/README.md +++ b/README.md @@ -4,7 +4,7 @@ This is the source of the Hopsworks Documentation published at Enable Hopsworks mapping @@ -26,9 +28,10 @@ If you can not find the variable ```hw_group_mapping_sync_enabled``` create it b ### Step 1: Create a mapping + To create a mapping go to **Cluster Settings** by clicking on your name in the top right corner of the navigation bar and choosing *Cluster Settings* from the dropdown menu. -In the _Project mapping_ tab, you can create a new mapping by clicking on _Create new mapping_. +In the *Project mapping* tab, you can create a new mapping by clicking on *Create new mapping*.
@@ -45,10 +48,10 @@ This will take you to the create mapping page shown below
Create mapping
-Here you can enter your Hopsworks group and map it to a project from the _Project_ drop down list. -You can also choose the _Project role_ users will be assigned when they are added to the project. +Here you can enter your Hopsworks group and map it to a project from the *Project* drop down list. +You can also choose the *Project role* users will be assigned when they are added to the project. -Finally, click on _Create mapping_ and go back to mappings. You should see the newly created mapping(s) as shown below. +Finally, click on *Create mapping* and go back to mappings. You should see the newly created mapping(s) as shown below.
@@ -59,7 +62,7 @@ Finally, click on _Create mapping_ and go back to mappings. You should see the n ### Step 2: Edit a mapping -From the list of mappings click on the edit button (:material-pencil:). This will open a popup that will allow you to change the _group_, _project name_, and _project role_ of a mapping. +From the list of mappings click on the edit button (:material-pencil:). This will open a popup that will allow you to change the *group*, *project name*, and *project role* of a mapping.
@@ -69,11 +72,11 @@ From the list of mappings click on the edit button (:material-pencil:). This wil
!!!Warning - Updating a mapping's _group_ or _project name_ will remove all members of the previous group from the project. + Updating a mapping's *group* or *project name* will remove all members of the previous group from the project. ### Step 3: Delete a mapping To delete a mapping click on the delete button. !!!Warning - Deleting a mapping will remove all members of that group from the project. \ No newline at end of file + Deleting a mapping will remove all members of that group from the project. diff --git a/docs/setup_installation/admin/oauth2/configure-project-mapping.md b/docs/setup_installation/admin/oauth2/configure-project-mapping.md index 590bdbd0c..5af61a227 100644 --- a/docs/setup_installation/admin/oauth2/configure-project-mapping.md +++ b/docs/setup_installation/admin/oauth2/configure-project-mapping.md @@ -1,14 +1,17 @@ # Configure OAuth2 group to project mapping ## Introduction + A group-to-project mapping lets you automatically add all members of an OAuth2 group to a project, eliminating the need to add each user individually. To create a mapping, you simply select an OAuth2 group, choose the project it should be linked to, and assign the role that its members will have within that project. Once a mapping is created, project membership is controlled through OAuth2 group membership. Any updates made to the OAuth2 group—such as adding or removing users—will automatically be reflected in Hopsworks. For example, if a user is removed from the OAuth2 group, they will also be removed from the corresponding project. ## Prerequisites + 1. A server configured with OAuth2. See [Register Identity Provider in Hopsworks](./create-client.md) for instructions on how to do this. 2. OAuth2 group mapping sync enabled. This can be done by setting the variable ```oauth_group_mapping_sync_enabled=true```. See [Cluster Configuration](../variables.md) on how to change variable values in Hopsworks. +
Enable OAuth2 mapping @@ -26,9 +29,10 @@ If you can not find the variable ```oauth_group_mapping_sync_enabled``` create i
### Step 1: Create a mapping + To create a mapping go to **Cluster Settings** by clicking on your name in the top right corner of the navigation bar and choosing *Cluster Settings* from the dropdown menu. -In the _Project mapping_ tab, you can create a new mapping by clicking on _Create new mapping_. +In the *Project mapping* tab, you can create a new mapping by clicking on *Create new mapping*.
@@ -45,10 +49,10 @@ This will take you to the create mapping page shown below
Create mapping
-Here you can enter your OAuth2 group and map it to a project from the _Project_ drop down list. -You can also choose the _Project role_ users will be assigned when they are added to the project. +Here you can enter your OAuth2 group and map it to a project from the *Project* drop down list. +You can also choose the *Project role* users will be assigned when they are added to the project. -Finally, click on _Create mapping_ and go back to mappings. You should see the newly created mapping(s) as shown below. +Finally, click on *Create mapping* and go back to mappings. You should see the newly created mapping(s) as shown below.
@@ -64,7 +68,7 @@ Finally, click on _Create mapping_ and go back to mappings. You should see the n ### Step 2: Edit a mapping -From the list of mappings click on the edit button (:material-pencil:). This will open a popup that will allow you to change the _remote group_, _project name_, and _project role_ of a mapping. +From the list of mappings click on the edit button (:material-pencil:). This will open a popup that will allow you to change the *remote group*, *project name*, and *project role* of a mapping.
@@ -74,11 +78,11 @@ From the list of mappings click on the edit button (:material-pencil:). This wil
!!!Warning - Updating a mapping's _remote group_ or _project name_ will remove all members of the previous group from the project. + Updating a mapping's *remote group* or *project name* will remove all members of the previous group from the project. ### Step 3: Delete a mapping To delete a mapping click on the delete button. !!!Warning - Deleting a mapping will remove all members of that group from the project. \ No newline at end of file + Deleting a mapping will remove all members of that group from the project. diff --git a/docs/templates/python/material/attribute.html.jinja b/docs/templates/python/material/attribute.html.jinja index 8e0f9b2f9..97eb8ebe3 100644 --- a/docs/templates/python/material/attribute.html.jinja +++ b/docs/templates/python/material/attribute.html.jinja @@ -2,7 +2,7 @@ {% block heading scoped %} {% block source_link scoped %} - {% if config.link_source and attribute.source_link %} + {% if config.extra.link_source and attribute.source_link %} [source] {% endif %} {% endblock source_link %} diff --git a/docs/templates/python/material/class.html.jinja b/docs/templates/python/material/class.html.jinja index 76b687016..40687fccf 100644 --- a/docs/templates/python/material/class.html.jinja +++ b/docs/templates/python/material/class.html.jinja @@ -2,7 +2,7 @@ {% block heading scoped %} {% block source_link scoped %} - {% if config.link_source and class.source_link %} + {% if config.extra.link_source and class.source_link %} [source] {% endif %} {% endblock source_link %} diff --git a/docs/templates/python/material/function.html.jinja b/docs/templates/python/material/function.html.jinja index 7cd8a95c1..7d621a25e 100644 --- a/docs/templates/python/material/function.html.jinja +++ b/docs/templates/python/material/function.html.jinja @@ -2,7 +2,7 @@ {% block heading scoped %} {% block source_link scoped %} - {% if config.link_source and function.source_link %} + {% if config.extra.link_source and function.source_link %} [source] {% endif %} {% endblock source_link %} diff --git a/docs/templates/python/material/module.html.jinja b/docs/templates/python/material/module.html.jinja index a4a624c85..a61acfda9 100644 --- a/docs/templates/python/material/module.html.jinja +++ b/docs/templates/python/material/module.html.jinja @@ -2,7 +2,7 @@ {% block heading scoped %} {% block source_link scoped %} - {% if config.link_source and module.source_link %} + {% if config.extra.link_source and module.source_link %} [source] {% endif %} {% endblock source_link %} diff --git a/docs/user_guides/projects/jobs/pyspark_job.md b/docs/user_guides/projects/jobs/pyspark_job.md index 79aad2173..2921f7bcf 100644 --- a/docs/user_guides/projects/jobs/pyspark_job.md +++ b/docs/user_guides/projects/jobs/pyspark_job.md @@ -251,7 +251,6 @@ The following table describes the job configuration parameters for a PYSPARK job | `conf['archives']` | string | Comma-separated string of HDFS path(s) to archives to be made available to the application. Example: `hdfs:///Project//Resources/archive.zip,...` | `null` | | `conf['properties']` | string | A new line separated (`\n`) list of properties to pass to the Spark application. The properties should be in the format `name=value` | `null` | - ## Accessing project data ### Read directly from the filesystem (recommended) diff --git a/docs/user_guides/projects/jobs/spark_job.md b/docs/user_guides/projects/jobs/spark_job.md index a3e744460..1fb25ff61 100644 --- a/docs/user_guides/projects/jobs/spark_job.md +++ b/docs/user_guides/projects/jobs/spark_job.md @@ -253,7 +253,6 @@ The following table describes the job configuration parameters for a SPARK job. | `conf['archives']` | string | Comma-separated string of HDFS path(s) to archives to be made available to the application. Example: `hdfs:///Project//Resources/archive.zip,...` | `null` | | `conf['properties']` | string | A new line separated (`\n`) list of properties to pass to the Spark application. The properties should be in the format `name=value` | `null` | - ## Accessing project data ### Read directly from the filesystem (recommended) diff --git a/mkdocs.yml b/mkdocs.yml index a42cc8c04..98588e794 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -346,9 +346,10 @@ plugins: show_symbol_type_heading: true show_symbol_type_toc: true show_source: false - link_source: true docstring_section_style: spacy annotations_path: source + extra: + link_source: true inventories: - https://docs.python.org/3/objects.inv - https://pandas.pydata.org/docs/objects.inv