search

MicrosoftDocs / azure-docs

Open source documentation of Microsoft Azure
https://docs.microsoft.com/azure
Creative Commons Attribution 4.0 International
10.27k stars 21.45k forks source link

Instructions on how to deploy to Azure Kubernetes Services #34876

Closed SpicySyntax closed 5 years ago

SpicySyntax commented 5 years ago

Hey this docs page is great and enabled me to get a container working great locally! However I would love some direction on how we can deploy these into an AKS cluster. Specifically, how do we authenticate the Kubernetes cluster to pull the container image, and how to we configure the pods to run with the Eula, ApiKey, and Billing Params. Thanks!

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

YutongTie-MSFT commented 5 years ago

@SpicySyntax Thank you for your feedback, I have assigned to author for proper update.

@IEvangelist Hi, could you please help to check this issue and update the document if necessary? Thank you!!

IEvangelist commented 5 years ago

Hi @SpicySyntax, thank you for your kind words - it made my night! You may be in luck, I just posted another doc on doing just that but under a different service. Does this help you out - Use Kubernetes on-premises?

Specifically

In these two sections you can see how we pass those container registry credentials into the K8s cluster. Also, you can see how we leverage a Helm chart to specify our EULA, API Key and Endpoint URL.

Please report back, if this doc solves your problem I will consider writing up something similar for Computer Vision. Looking forward to hearing back from you. Thanks again

SpicySyntax commented 5 years ago

@IEvangelist This is exactly what I was looking for! If you updated the CV docs with something like this, or even just linked to this that may help others like me down the line. Thank you both for your quick response!

SpicySyntax commented 5 years ago

@IEvangelist Sorry for the quick reopen, I realized I needed to clarify a few things that are text-recognition specific. what do I use instead of the keys 'speechToText' or 'textToSpeech' (I imagine something like: 'recognizeText'). Also, what is the helm chart I should target when doing the helm install. I looked at the Helm Hub but couldn't find a chart for recognize text. I guess it would be useful to have the CV services equivalent docs available since there are some subtle differences. Thanks again.

IEvangelist commented 5 years ago

Yes, I'm realizing that it would be helpful. Not all services are on the Helm hub and in fact, I'm not certain that they ever will be. I can tell you that if you're looking for the recognize text image it will be listed on the container repositories and images table. The image you're looking for is here:

containerpreview.azurecr.io/microsoft/cognitive-services-recognize-text

So this gets you the registry/repository/image now you just need to know without Helm how do you configure the required EULA, API Key and Endpoint URL - right? Admittedly, there are a few discrepancies between how the various Cognitive Services implement their containers, thus not all docs can be identical. With that said, does this doc help? This demonstrates using a YAML file to apply to the K8s cluster, I imagine that you'd be able to take the K8s cluster that has the registry secret and then apply the image settings like this -- obviously customizing it with the aforementioned image. Try this out and I'll add some backlog items to re-evaluate the docs to highlight some of the other scenarios.

SpicySyntax commented 5 years ago

@IEvangelist following these instructions I was able to deploy to my AKS cluster. Should I keep this open until the docs are updates?

IEvangelist commented 5 years ago

No, you can close it. But I'd welcome a pull request if you have time to update the doc with your Computer Vision examples? Or you could even email what you put together?

SpicySyntax commented 5 years ago

It is easier for me to email you. I just sent it off, let me know if you get it and it all looks good and I will close this. Thanks

IEvangelist commented 5 years ago

It is easier for me to email you. I just sent it off, let me know if you get it and it all looks good and I will close this. Thanks

Thanks for the email... that is perfect, thanks again kind sir and good day. I close this now. #please-close

IEvangelist commented 5 years ago

Hi @SpicySyntax,

I just wanted to let you know that we've introduced a new article based on your feedback - it's live... enjoy, and feel free to share!

https://docs.microsoft.com/en-us/azure/cognitive-services/computer-vision/deploy-computer-vision-on-premises

Thanks again for reaching out and helping to collaborate on this.