az-deep-realtime-score/Keras_Tensorflow
YanZhangADS 8c4ef33fa0 enhance doc 2019-01-25 13:50:31 +00:00
..
00_AMLSetup.ipynb add parameters tag 2019-01-11 19:04:57 +00:00
01_DevelopModel.ipynb add parameters tag 2019-01-11 19:04:57 +00:00
02_DevelopModelDriver.ipynb enhance doc 2019-01-24 20:37:19 +00:00
03_BuildImage.ipynb add parameters tag 2019-01-11 19:04:57 +00:00
04_DeployOnAKS.ipynb fix package import 2019-01-24 20:22:50 +00:00
05_TestWebApp.ipynb add readme, remove cell output 2018-12-20 16:20:55 +00:00
06_SpeedTestWebApp.ipynb enhance doc 2019-01-25 13:50:31 +00:00
07_TearDown.ipynb fix a bug 2019-01-23 19:10:08 +00:00
README.md enhance doc 2019-01-22 15:05:01 +00:00
resnet152.py Helper files for the notebook 2018-10-19 10:46:06 -04:00
testing_utilities.py use gpu cluster, dotenv 2018-12-20 12:20:18 +00:00
tutorial_env.yml add parameters tag 2019-01-11 19:04:57 +00:00

README.md

Deploy Deep Learning CNN on Kubernetes Cluster with GPUs - Keras

To get started with the tutorial, please proceed with following steps in sequential order.

Prerequisites

  1. Linux(Ubuntu) with GPU enabled.
  2. Anaconda Python
  3. Docker installed.
  4. Azure account.

The tutorial was developed on an Azure Ubuntu DSVM, which addresses the first three prerequisites.

Setup

To set up your environment to run these notebooks, please follow these steps. They setup the notebooks to use Docker and Azure seamlessly.

  1. Create a Linux DSVM (NC6 or above to use GPU).

  2. Clone, fork, or download the zip file for this repository:

    git clone https://github.com/Microsoft/AKSDeploymentTutorial_AML.git
    
  3. Add your user to the docker group (after executing this command, exit and start a new bash shell):

    sudo usermod -aG docker $USER
    

    To verify whether you have correct configuration, try executing docker ps command. You should not get permission denied errors.

  4. Navigate to ./AKSDeploymentTutorial_AML/Keras_Tensorflow directory

  5. Create the Python virtual environment using the tutorial_env.yml:

    conda env create -f tutorial_env.yml
    
  6. Activate the virtual environment:

    source activate tutorial_env
    
  7. Login to Azure:

    az login
    
  8. If you have more than one Azure subscription, select it:

    az account set --subscription <Your Azure Subscription>
    
  9. Start the Jupyter notebook server in the virtual environment:

    jupyter notebook
    

Steps

After following the setup instructions above, run the Jupyter notebooks in order starting with the first notebook 00_AMLSetup.ipynb.

Cleaning up

To remove the conda environment created see here. The last Jupyter notebook also gives details on deleting Azure resources associated with this repository.

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.

When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repositories using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.