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

docs(*:skip) Update SuperNode docker example #3722

Draft
wants to merge 19 commits into
base: main
Choose a base branch
from

Conversation

Robert-Steiner
Copy link
Member

Issue

Description

Related issues/PRs

Proposal

Explanation

Checklist

  • Implement proposed change
  • Write tests
  • Update documentation
  • Make CI checks pass
  • Ping maintainers on Slack (channel #contributions)

Any other comments?

@Robert-Steiner Robert-Steiner self-assigned this Jul 5, 2024
@Robert-Steiner Robert-Steiner force-pushed the doc/update-supernode-docker-image branch 7 times, most recently from 9ccd11f to dbb94bb Compare July 17, 2024 13:22
Copy link
Contributor

@chongshenng chongshenng left a comment

Choose a reason for hiding this comment

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

Hi @Robert-Steiner, I've reviewed mainly the Quickstart and have suggested some changes. About including dependencies in the Dockerfile, I prefer if we can show how to use pyproject.toml to reduce copy-pasting dependencies across files. Can you also check the flwr run execution? I think it's missing some arguments to run on the Docker SuperExec/SuperLink.

doc/source/docker/index.rst Outdated Show resolved Hide resolved
doc/source/docker/persist-state.rst Outdated Show resolved Hide resolved
doc/source/docker/persist-state.rst Outdated Show resolved Hide resolved
doc/source/docker/persist-state.rst Outdated Show resolved Hide resolved
doc/source/docker/persist-state.rst Outdated Show resolved Hide resolved
doc/source/docker/quickstart.rst Outdated Show resolved Hide resolved
doc/source/docker/quickstart.rst Outdated Show resolved Hide resolved
doc/source/docker/quickstart.rst Outdated Show resolved Hide resolved
doc/source/docker/quickstart.rst Outdated Show resolved Hide resolved
doc/source/docker/quickstart.rst Outdated Show resolved Hide resolved
@Robert-Steiner Robert-Steiner force-pushed the doc/update-supernode-docker-image branch from 4a0bab1 to cae146e Compare July 19, 2024 09:43
@Robert-Steiner Robert-Steiner force-pushed the doc/update-supernode-docker-image branch 2 times, most recently from 8e383e9 to 47e3867 Compare July 24, 2024 09:08
Signed-off-by: Robert Steiner <[email protected]>
Signed-off-by: Robert Steiner <[email protected]>
Signed-off-by: Robert Steiner <[email protected]>
Signed-off-by: Robert Steiner <[email protected]>
Signed-off-by: Robert Steiner <[email protected]>
Signed-off-by: Robert Steiner <[email protected]>
Signed-off-by: Robert Steiner <[email protected]>
Signed-off-by: Robert Steiner <[email protected]>
@Robert-Steiner Robert-Steiner force-pushed the doc/update-supernode-docker-image branch 2 times, most recently from 46fde7e to bd7032e Compare July 24, 2024 11:28
Signed-off-by: Robert Steiner <[email protected]>
@Robert-Steiner Robert-Steiner force-pushed the doc/update-supernode-docker-image branch from bd7032e to ccf511b Compare July 24, 2024 13:53
Copy link
Contributor

@chongshenng chongshenng left a comment

Choose a reason for hiding this comment

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

Thanks @Robert-Steiner for the updates! A few more minor suggestions on the other pages.

doc/source/contributor-how-to-build-docker-images.rst Outdated Show resolved Hide resolved
doc/source/contributor-how-to-build-docker-images.rst Outdated Show resolved Hide resolved
doc/source/contributor-how-to-build-docker-images.rst Outdated Show resolved Hide resolved
doc/source/contributor-how-to-build-docker-images.rst Outdated Show resolved Hide resolved
doc/source/contributor-how-to-build-docker-images.rst Outdated Show resolved Hide resolved

$ docker run --rm \
--volume ./ca.crt:/app/ca.crt/:ro \
flwr/supernode:|current_flwr_version| \
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
flwr/supernode:|current_flwr_version| \
flwr/supernode:|stable_flwr_version| \

| current working directory of the host machine as a read-only volume at the ``/app/ca.crt``
| directory inside the container.
* | :substitution-code:`flwr/supernode:|current_flwr_version|`: The name of the image to be run and the specific
| tag of the image. The tag :substitution-code:`|current_flwr_version|` represents a specific version of the image.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
| tag of the image. The tag :substitution-code:`|current_flwr_version|` represents a specific version of the image.
| tag of the image. The tag :substitution-code:`|stable_flwr_version|` represents a specific version of the image.

doc/source/docker/tls.rst Outdated Show resolved Hide resolved

$ docker run --rm \
--volume ./certificates/:/app/certificates/:ro \
flwr/superexec:|current_flwr_version| \
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
flwr/superexec:|current_flwr_version| \
flwr/superexec:|stable_flwr_version| \

| This allows the container to access the TLS certificates that are stored in the certificates
| directory.
* | :substitution-code:`flwr/superexec:|current_flwr_version|`: The name of the image to be run and the specific
| tag of the image. The tag :substitution-code:`|current_flwr_version|` represents a specific version of the image.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
| tag of the image. The tag :substitution-code:`|current_flwr_version|` represents a specific version of the image.
| tag of the image. The tag :substitution-code:`|stable_flwr_version|` represents a specific version of the image.

@Robert-Steiner Robert-Steiner force-pushed the doc/update-supernode-docker-image branch from da06b05 to 157f15a Compare July 25, 2024 12:30
Signed-off-by: Robert Steiner <[email protected]>
@Robert-Steiner Robert-Steiner force-pushed the doc/update-supernode-docker-image branch from 157f15a to 9135310 Compare July 25, 2024 12:30
@Robert-Steiner
Copy link
Member Author

Thanks @Robert-Steiner for the updates! A few more minor suggestions on the other pages.

@chongshenng, thanks for the great feedback! I tried to address all the comments. Let me know in case I missed one. Regarding renaming current_flwr_version to stable_flwr_version. I synced with @charlesbvll, and he is going to create a new separate PR because the variable is not only used in the docker docs. I will update this PR once it has been merged.

Signed-off-by: Robert Steiner <[email protected]>
@Robert-Steiner Robert-Steiner force-pushed the doc/update-supernode-docker-image branch from e636b51 to e318719 Compare July 25, 2024 19:06
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.

None yet

2 participants