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

[Doc][Serve] Document for HTTPS #3972

Open
wants to merge 6 commits into
base: master
Choose a base branch
from
Open

[Doc][Serve] Document for HTTPS #3972

wants to merge 6 commits into from

Conversation

cblmemo
Copy link
Collaborator

@cblmemo cblmemo commented Sep 23, 2024

Related to and block by #3380.

Tested (run the relevant ones):

  • Code formatting: bash format.sh
  • Any manual or new tests for this PR (please specify below)
  • All smoke tests: pytest tests/test_smoke.py
  • Relevant individual smoke tests: pytest tests/test_smoke.py::test_fill_in_the_name
  • Backward compatibility tests: conda deactivate; bash -i tests/backward_compatibility_tests.sh

@cblmemo cblmemo mentioned this pull request Sep 23, 2024
6 tasks
@cblmemo cblmemo requested a review from Michaelvll October 1, 2024 23:00
@cblmemo
Copy link
Collaborator Author

cblmemo commented Oct 10, 2024

bump for review @Michaelvll

Copy link
Collaborator

@Michaelvll Michaelvll left a comment

Choose a reason for hiding this comment

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

Thanks for adding the doc @cblmemo! Looks mostly good to me.

@@ -161,6 +161,7 @@ Read the research:
../serving/sky-serve
../serving/user-guides
../serving/service-yaml-spec
../serving/https
Copy link
Collaborator

Choose a reason for hiding this comment

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

Should we have it at the top level of the doc or in the user-guides?

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

This feels more like a serving dedicated guide to me as putting it in other places is possible to left the impression that this doc is for https on a cluster with ports exposed.. wdyt?

HTTPS on Load Balancer
----------------------

To enable HTTPS on the load balancer, you need to provide a certificate and a private key. Obtaining these from a trusted Certificate Authority (CA) is the most secure method. However, for development and testing purposes, you can generate a self-signed certificate and private key using the :code:`openssl` command-line tool. Here is an example of how to generate them:
Copy link
Collaborator

Choose a reason for hiding this comment

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

We should have a section talking about common ways to get certificate for people who want to do it in production.

Copy link
Collaborator

Choose a reason for hiding this comment

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

Also, does a normal HTTPS requires periodic refresh for the token?

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Good point! Lemme investigate and try it out.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Yes, they typically last for 3 months and up to 13 months. FastAPI doc says you cannot do that using uvicorn (see picture below). I think moving to envoy would address this problem.

https://fastapi.tiangolo.com/deployment/https/#certificate-renewal

image

docs/source/serving/https.rst Outdated Show resolved Hide resolved
docs/source/serving/https.rst Outdated Show resolved Hide resolved
@cblmemo cblmemo requested a review from Michaelvll October 24, 2024 23:36
@cblmemo
Copy link
Collaborator Author

cblmemo commented Oct 24, 2024

@Michaelvll updated. PTAL again!

@cblmemo cblmemo added this to the v0.7 milestone Oct 25, 2024
@romilbhardwaj romilbhardwaj removed this from the v0.7 milestone Oct 29, 2024
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.

3 participants