mirror of https://github.com/kubeflow/examples.git
Remove demo container refs, assume users build
This commit is contained in:
parent
4e1e42a088
commit
fbf43567d8
|
|
@ -1,7 +1,5 @@
|
|||
# Reinforcement Learning with [tensorflow/agents](https://github.com/tensorflow/agents)
|
||||
|
||||
[](https://quay.io/repository/cwbeitel/agents-demo)
|
||||
|
||||
Here we provide a demonstration of training a reinforcement learning agent to perform a robotic grasping task using Kubeflow running on Google Kubernetes Engine. In this demonstration you will learn how to paramaeterize a training job, submit it to run on your cluster, monitor the job including launching a tensorboard instance, and finally producing renders of the agent performing the robotic grasping task.
|
||||
|
||||
For clarity and fun you can check out what the product of this tutorial will look like by clicking through the render screenshot below to a short video of a trained agent performing a simulated robotic block grasping task:
|
||||
|
|
@ -12,6 +10,18 @@ Below are instructions to first set up various preliminaries then launch the exa
|
|||
|
||||
### Setup
|
||||
|
||||
##### Building the demo container
|
||||
|
||||
First, we'll need to build a container that includes the demo code that we can later run on JupyterHub. From the root of the example directory this can be done in the usual way:
|
||||
|
||||
```bash
|
||||
TAG=[registry]/[project or user]/[tag]
|
||||
docker build -t $TAG -f doc/Dockerfile .
|
||||
docker push $TAG
|
||||
```
|
||||
|
||||
Provided the above $TAG refers to a registry for which the user has authenticated via `docker login ...`.
|
||||
|
||||
##### GCP and Kubeflow configuration
|
||||
|
||||
This tutorial assumes you have deployed a Kubernetes cluster on your provider of choice and have completed the steps described in the [Kubeflow User Guide](https://github.com/kubeflow/kubeflow/blob/master/user_guide.md) to deploy the core, argo, and nfs components.
|
||||
|
|
@ -25,32 +35,15 @@ kubectl create namespace ${NAMESPACE}
|
|||
|
||||
Note the above command assumes you have already pulled the credentials for your Kubernetes cluster locally as described in the [Kubeflow User Guide](https://github.com/kubeflow/kubeflow/blob/master/user_guide.md).
|
||||
|
||||
### Running the demo on JupyterHub
|
||||
|
||||
In order to run this demo on a Kubeflow JupyterHub deployment you'll need the registry address of a demo container that is accessible to that Kubeflow deployment. This can be accomplished using the public container image for this demo, `quay.io/cwbeitel/agents-demo`, or by building the demo container yourself.
|
||||
|
||||
Please refer to [these docs](https://github.com/kubeflow/kubeflow/blob/master/user_guide.md) for accessing your JupyterHub deployment.
|
||||
|
||||
##### Launching
|
||||
|
||||
To run the examples on a Kubeflow JupyterHub deployment simply provide the registry address of your demonstration container, e.g. `quay.io/cwbeitel/agents-demo`, in the image field of the spawner options dialog.
|
||||
To run the examples on a Kubeflow JupyterHub deployment you may provide the registry address of your demonstration container in the image field of the spawner options dialog.
|
||||
|
||||
Here's approximately what that looks like for me:
|
||||
|
||||

|
||||
|
||||
For troubleshooting of your JupyterHub spawn or anything else related to your Kubeflow deployment please refer to the [Kubeflow User Guide](https://github.com/kubeflow/kubeflow/blob/master/user_guide.md).
|
||||
For general troubleshooting of the spawning of notebook containers on JupyterHub or anything else related to your Kubeflow deployment please refer to the [Kubeflow User Guide](https://github.com/kubeflow/kubeflow/blob/master/user_guide.md).
|
||||
|
||||
Well it looks like our initial setup is finished 🎉🎉 and it's time to start playing around with that shiny new demonstration notebook!!
|
||||
|
||||
##### Building your own development container
|
||||
|
||||
We might want to include various additional dependencies in our notebook container to aid in development of our model. In that case we might be interested in modifying the demo Dockerfile and re-building the container.
|
||||
|
||||
The demo container can be built using the standard workflow:
|
||||
|
||||
```bash
|
||||
TAG=quay.io/someuser/agents-demo:version
|
||||
docker build -t ${TAG} .
|
||||
docker push ${TAG}
|
||||
```
|
||||
|
|
|
|||
Loading…
Reference in New Issue