Skip to content

added new Brev launchable instructions - #733

Merged
jayavenkatesh19 merged 2 commits into
rapidsai:mainfrom
jayavenkatesh19:brev-launchable-update
Aug 4, 2026
Merged

added new Brev launchable instructions#733
jayavenkatesh19 merged 2 commits into
rapidsai:mainfrom
jayavenkatesh19:brev-launchable-update

Conversation

@jayavenkatesh19

@jayavenkatesh19 jayavenkatesh19 commented Aug 4, 2026

Copy link
Copy Markdown
Contributor

Updates the Brev launchable instructions to reflect the new UI changes on Brev.

While testing this out, I also found a few bugs and made some changes in the old Docker Compose YAML file:

  • backend (now renamed to jupyter) was not nested under services and was failing YAML parsing
  • --ip=127.0.0.1 changed to --ip=0.0.0.0. I could not reach the earlier Jupyter endpoint over the internet and this configuration change worked
  • Dropped working directory and --notebook-dir=/notebooks. This was showing up in Jupyterlab as an empty folder and not with the examples as intended
  • Mounting any code repositories as a volume and using Brev's source section to clone it. This ensures that the files in the repo are visible on Jupyterlab
  • EXTRA_CONDA_PACKAGES is now a launch configuration variable with the value being passed to the container. This way users can customize their packages at deploy time rather than the Launchable creation time

I added screenshots of every single section, and tested everything out end to end. This new configuration ensures a healthy Jupyterlab, with access to any cloned repositories and all of the example notebooks.

@jayavenkatesh19 jayavenkatesh19 self-assigned this Aug 4, 2026
@jayavenkatesh19
jayavenkatesh19 requested a review from a team as a code owner August 4, 2026 05:59

@ncclementi ncclementi left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Looks pretty good. I think the docker compose should be self contained. like the equivalent to launching things via UI.

# Remove this entry if you are not adding a repository.
- /home/ubuntu/<name_of_your_github_repo>:/home/rapids/notebooks/<name_of_your_github_repo>
user: root
command: jupyter-lab --notebook-dir=/home/rapids/notebooks --ip=0.0.0.0 --no-browser --allow-root --NotebookApp.token='' --NotebookApp.allow_origin='*'

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

I understand the 0.0.0.0 but I'm not sure if that's secure enough. Should we ask the Brev team about this?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

We can ask them about this yes, but while debugging I couldn't find a way to make the 127.0.0.1 work. I even tried without the --NotebookApp.token=' ' which disables authentication. We can ask the Brev team about how internet access/firewall rules are setup

count: all
capabilities: [gpu]
environment:
- EXTRA_CONDA_PACKAGES # Value comes from a launch parameter of the same name

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

If we give put thsi as an example, don't we need : and some packages to show teh exmaple?

I'm worried this dockerfile won't work as is.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

We don't need it, as this variable is populated from the value from the Launch Parameters section. I added hdbscan and umap in launch parameters and I could import those packages in the Notebooks

Comment on lines +94 to +97
volumes:
# Repo cloned by the Source section, mounted alongside the example notebooks.
# Remove this entry if you are not adding a repository.
- /home/ubuntu/<name_of_your_github_repo>:/home/rapids/notebooks/<name_of_your_github_repo>

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

I assume we remove this to mount the whole repo and not map it to the notebooks directory right? Just wanted to make sure

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

The reason for doing this was to keep the example notebooks visible to the user. If we map to the notebooks directory, users can see the cudf, cugraph, cuml examples folders along with the cloned repo added as the fourth folder in the root of the mounted path


```yaml
environment:
- EXTRA_CONDA_PACKAGES

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Have you checked once the instance is launched if the extra packages installed work?
To see if they were properly installed?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Yep I could import them into the notebook without any errors.

@ncclementi ncclementi left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

pending understanding on the 0.0.0.0 change.

@jayavenkatesh19

Copy link
Copy Markdown
Contributor Author

Confirmed with the Brev team that they switched from using Cloudflare for secure links to an internal tool called Skybridge which only supports external access through the 0.0.0.0 IP address.
Merging this PR!

@jayavenkatesh19
jayavenkatesh19 merged commit fec9f85 into rapidsai:main Aug 4, 2026
4 checks passed
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.

2 participants