Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Expand documentation to cover local test and development #1917

Merged
merged 8 commits into from
Feb 2, 2025

Conversation

rgaiacs
Copy link
Contributor

@rgaiacs rgaiacs commented Jan 27, 2025

No description provided.

@rgaiacs rgaiacs self-assigned this Jan 27, 2025
@rgaiacs
Copy link
Contributor Author

rgaiacs commented Jan 27, 2025

The config.yaml that I used when testing the instructions is

config:
  BinderHub:
    use_registry: false
    image_prefix: gesiscss/binder-
    hub_url: http://jupyterhub.10.6.46.141.nip.io

service:
  type: ClusterIP

ingress:
  enabled: true
  annotations:
    # use the shared ingress-nginx
    kubernetes.io/ingress.class: "nginx"
  https:
      # This is unsafe! Only se for local development
      enabled: false
  hosts:
    - binderhub.10.6.46.141.nip.io

jupyterhub:
  proxy:
    service:
     type: ClusterIP
  ingress:
    enabled: true
    annotations:
      # use the shared ingress-nginx
      kubernetes.io/ingress.class: "nginx"
    hosts:
      - jupyterhub.10.6.46.141.nip.io

Exposing JupyterHub
~~~~~~~~~~~~~~~~~~~

By default, JupyterHub is exposed as ``LoadBalancer``.
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
By default, JupyterHub is exposed as ``LoadBalancer``.
By default, JupyterHub is exposed as a ``LoadBalancer``.

~~~~~~~~~~~~~~~~~~~

By default, JupyterHub is exposed as ``LoadBalancer``.
If you want to expose JupyterHub using a ingress controller,
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
If you want to expose JupyterHub using a ingress controller,
If you want to expose JupyterHub using an ingress controller,


The above snippet assumes that you are using `Ingress NGINX Controller <https://kubernetes.github.io/ingress-nginx/>`_
and uses `nip.io <https://nip.io/>`_ to provide you with a temporary domain
to the IPv6 ``XXX.XXX.XXX.XXX``.
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
to the IPv6 ``XXX.XXX.XXX.XXX``.
to the IP ``XXX.XXX.XXX.XXX``.

ingress:
enabled: true
annotations:
# use the shared ingress-nginx
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
# use the shared ingress-nginx
# replace with your ingress class

on the registry you are using.
Create a file called ``config.yaml``.

Exposing JupyterHub
Copy link
Member

Choose a reason for hiding this comment

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

Rather than repeating yourself I think we could just say JupyterHub and BinderHub are exposed as LoadBalancers by default....., then give both configs and only talk about Nginx ingress once.

When using ``Ingress``
~~~~~~~~~~~~~~~~~~~~~~

If JupyterHub is exposed using ``Ingress``,
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
If JupyterHub is exposed using ``Ingress``,
If JupyterHub is exposed using an ``Ingress``,

~~~~~~~~~~~~~~~~~~~~~~

If JupyterHub is exposed using ``Ingress``,
you can use any of the domains that JupyterHub is answering.
Copy link
Member

Choose a reason for hiding this comment

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

What do you mean by this? Only jupyterhub.XXX.XXX.XXX.XXX.nip.io is configured.

BinderHub:
hub_url: http://jupyterhub.XXX.XXX.XXX.XXX.nip.io

The above snippet `nip.io <https://nip.io/>`_
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
The above snippet `nip.io <https://nip.io/>`_
The above snippet uses `nip.io <https://nip.io/>`_

hub_url: http://jupyterhub.XXX.XXX.XXX.XXX.nip.io

The above snippet `nip.io <https://nip.io/>`_
to provide you with a temporary domain to the IPv6 ``XXX.XXX.XXX.XXX``.
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
to provide you with a temporary domain to the IPv6 ``XXX.XXX.XXX.XXX``.
to provide you with a temporary domain to the IP ``XXX.XXX.XXX.XXX``.

based on review.

Thanks to @manics.
@rgaiacs rgaiacs requested a review from manics January 30, 2025 12:59
@rgaiacs
Copy link
Contributor Author

rgaiacs commented Jan 30, 2025

Suggested changes were addressed.

Copy link
Member

@manics manics left a comment

Choose a reason for hiding this comment

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

Thanks!

@manics manics merged commit d8bedee into jupyterhub:main Feb 2, 2025
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants