创建MXJob
功能介绍
创建MXJob。
MXJob即MXNet任务,是基于MXNet开源框架的kubernetes自定义资源类型,有多种角色可以配置,能够帮助我们更简单地实现MXNet的训练。MXNet开源框架的信息详见:https://mxnet.incubator.apache.org/。
URI
POST /apis/kubeflow.org/v1/namespaces/{namespace}/mxjobs
参数 |
是否必选 |
描述 |
---|---|---|
namespace |
Yes |
object name and auth scope, such as for teams and projects |
参数 |
是否必选 |
描述 |
---|---|---|
pretty |
No |
If 'true’, then the output is pretty printed. |
请求消息
请求参数:
请求参数的详细描述请参考表162。
请求示例:
{ "apiVersion": "kubeflow.org/v1", "kind": "MXJob", "metadata": { "name": "mxnet-job" }, "spec": { "cleanPodPolicy": "Running", "jobMode": "MXTrain", "mxReplicaSpecs": { "Scheduler": { "replicas": 1, "restartPolicy": "Never", "template": { "spec": { "imagePullSecrets": [ { "name": "imagepull-secret" } ], "containers": [ { "name": "mxnet", "image": "*.*.*.215:20202/cci/mxnet:xsw-dis", "command": [ "/bin/bash" ], "args": [ "-c", "python train_imagenet.py" ], "resources": { "requests": { "cpu": "1000m", "memory": "2Gi" }, "limits": { "cpu": "1000m", "memory": "2Gi" } } } ] } } }, "Server": { "replicas": 1, "restartPolicy": "Never", "template": { "spec": { "imagePullSecrets": [ { "name": "imagepull-secret" } ], "containers": [ { "name": "mxnet", "image": "*.*.*.215:20202/cci/mxnet:xsw-dis", "command": [ "/bin/bash" ], "args": [ "-c", "python train_imagenet.py" ], "resources": { "requests": { "cpu": "1000m", "memory": "2Gi" }, "limits": { "cpu": "1000m", "memory": "2Gi" } } } ] } } }, "Worker": { "replicas": 1, "restartPolicy": "Never", "template": { "spec": { "imagePullSecrets": [ { "name": "imagepull-secret" } ], "containers": [ { "name": "mxnet", "image": "*.*.*.215:20202/cci/mxnet:xsw-dis", "command": [ "/bin/bash" ], "args": [ "-c", "python train_imagenet.py --benchmark 1 --network resnet --batch-size 1 --num-epochs 1 --kv-store dist_sync --num-examples 500" ], "resources": { "requests": { "cpu": "1000m", "memory": "2Gi" }, "limits": { "cpu": "1000m", "memory": "2Gi" } } } ] } } } } } }
响应消息
响应参数:
响应参数的详细描述请参考表162。
响应示例:
{ "apiVersion": "kubeflow.org/v1", "kind": "MXJob", "metadata": { "creationTimestamp": "2019-07-24T08:42:33Z", "generation": 1, "name": "mxnet-job", "namespace": "kube-test", "resourceVersion": "72476154", "selfLink": "/apis/kubeflow.org/v1/namespaces/kube-test/mxjobs/mxnet-job", "uid": "fac6dcd2-adee-11e9-8041-340a9837e2a7" }, "spec": { "cleanPodPolicy": "Running", "jobMode": "MXTrain", "mxReplicaSpecs": { "Scheduler": { "replicas": 1, "restartPolicy": "Never", "template": { "spec": { "containers": [ { "args": [ "-c", "python train_imagenet.py" ], "command": [ "/bin/bash" ], "image": "*.*.*.215:20202/cci/mxnet:xsw-dis", "name": "mxnet", "resources": { "limits": { "cpu": "1000m", "memory": "2Gi" }, "requests": { "cpu": "1000m", "memory": "2Gi" } } } ], "imagePullSecrets": [ { "name": "imagepull-secret" } ] } } }, "Server": { "replicas": 1, "restartPolicy": "Never", "template": { "spec": { "containers": [ { "args": [ "-c", "python train_imagenet.py" ], "command": [ "/bin/bash" ], "image": "*.*.*.215:20202/cci/mxnet:xsw-dis", "name": "mxnet", "resources": { "limits": { "cpu": "1000m", "memory": "2Gi" }, "requests": { "cpu": "1000m", "memory": "2Gi" } } } ], "imagePullSecrets": [ { "name": "imagepull-secret" } ] } } }, "Worker": { "replicas": 1, "restartPolicy": "Never", "template": { "spec": { "containers": [ { "args": [ "-c", "python train_imagenet.py --benchmark 1 --network resnet --batch-size 1 --num-epochs 1 --kv-store dist_sync --num-examples 500" ], "command": [ "/bin/bash" ], "image": "*.*.*.215:20202/cci/mxnet:xsw-dis", "name": "mxnet", "resources": { "limits": { "cpu": "1000m", "memory": "2Gi" }, "requests": { "cpu": "1000m", "memory": "2Gi" } } } ], "imagePullSecrets": [ { "name": "imagepull-secret" } ] } } } } }, "status": { } }
状态码
状态码 |
描述 |
---|---|
200 |
OK |
201 |
Created |
202 |
Accepted |
401 |
Unauthorized |
400 |
Badrequest |
500 |
Internal error |
403 |
Forbidden |