Modelarts (#420)

Modelarts

Reviewed-by: RusselSand
Reviewed-by: Vineet Pruthi
Reviewed-by: Anton Sidelnikov

.zuul.yaml

@@ -23,7 +23,7 @@
     parent: otcinfra-upload-image-quay
     provides: otce-container-image
     vars: *otce_image_vars
-    nodeset: ubuntu-focal
+    nodeset: ubuntu-jammy
 
 - project:
     merge-mode: squash-merge

Dockerfile

@@ -11,13 +11,13 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-FROM docker.io/opendevorg/python-builder:3.9 as builder
+FROM docker.io/opendevorg/python-builder:3.9-bullseye as builder
 
 COPY . /tmp/src
 RUN echo "python-openstackclient" >> /tmp/src/requirements.txt
 RUN assemble
 
-FROM docker.io/opendevorg/python-base:3.9
+FROM docker.io/opendevorg/python-base:3.9-bullseye
 
 COPY --from=builder /output/ /output
 RUN /output/install-from-bindep

doc/source/cli/index.rst

@@ -40,6 +40,7 @@ documentation of these services:
    identity
    kms
    load_balancer
+   modelarts
    nat
    obs
    rds_v3

doc/source/cli/modelarts.rst

@@ -0,0 +1,68 @@
+Modelarts Service (modelarts)
+=============================
+
+The Modelarts client is the command-line interface (CLI) for
+the ModelArts service API and its extensions.
+
+For help on a specific `rds` command, enter:
+
+.. code-block:: console
+
+   $ openstack ma help SUBCOMMAND
+
+.. _builtin_model:
+
+Built-In Model Operations
+-------------------------
+
+.. autoprogram-cliff:: openstack.modelartsv1.v1
+   :command: ma builtin model *
+
+.. _devenv:
+
+Devenv Operations
+-----------------
+
+.. autoprogram-cliff:: openstack.modelartsv1.v1
+   :command: ma devenv *
+
+.. _model:
+
+Model Operations
+----------------
+
+.. autoprogram-cliff:: openstack.modelartsv1.v1
+   :command: ma model *
+
+.. _service:
+
+Service Operations
+------------------
+
+.. autoprogram-cliff:: openstack.modelartsv1.v1
+   :command: ma service *
+
+.. _training_job:
+
+Training Job Operations
+-----------------------
+
+.. autoprogram-cliff:: openstack.modelartsv1.v1
+   :command: ma training job *
+
+.. _visualization_job:
+
+Visualization Job Operations
+----------------------------
+
+.. autoprogram-cliff:: openstack.modelartsv1.v1
+   :command: ma visualization job *
+
+.. _dataset:
+
+Dataset Operations
+------------------
+
+.. autoprogram-cliff:: openstack.modelartsv2.v2
+   :command: ma dataset *
+

doc/source/coverage.rst

@@ -107,6 +107,12 @@ under several service tags. This may change in future.
       - X
       -
       -
+    * - modelarts
+      - ModelArts Service
+      - X
+      - X
+      - X
+      -
     * - nat
       - Network Address Translation
       - X

doc/source/sdk/guides/index.rst

@@ -24,6 +24,7 @@ Open Telekom Cloud related User Guides
    kms
    lts
    mrs
+   modelarts
    nat
    rds
    sfsturbo

doc/source/sdk/guides/modelarts.rst

@@ -0,0 +1,229 @@
+ModelArts Service
+=================
+
+ModelArts is a one-stop development platform for AI developers.
+With distributed training, automated model building, and model
+deployment, ModelArts helps AI developers quickly build models
+and efficiently manage the AI development lifecycle.
+
+.. contents:: Table of Contents
+   :local:
+
+Devenv Instance
+---------------
+
+List Devenv Instances
+^^^^^^^^^^^^^^^^^^^^^
+
+This interface is used to query devenv instances list.
+:class:`~otcextensions.sdk.modelartsv1.v1.devenv.Devenv`.
+
+.. literalinclude:: ../examples/modelartsv1/list_devenv_instances.py
+   :lines: 15-21
+
+Create Devenv Instance
+^^^^^^^^^^^^^^^^^^^^^^
+
+This interface is used to create a devenv instance with
+parameters.
+:class:`~otcextensions.sdk.modelartsv1.v1.devenv.Devenv`.
+
+.. literalinclude:: ../examples/modelartsv1/create_devenv_instance.py
+   :lines: 15-35
+
+Get Devenv Instance
+^^^^^^^^^^^^^^^^^^^
+
+This interface is used to get a devenv instance by ID
+or an instance of class.
+:class:`~otcextensions.sdk.modelartsv1.v1.devenv.Devenv`.
+
+.. literalinclude:: ../examples/modelartsv1/get_devenv_instance.py
+   :lines: 15-22
+
+Find Devenv Instance
+^^^^^^^^^^^^^^^^^^^^
+
+This interface is used to find a devenv instance by id or name.
+:class:`~otcextensions.sdk.modelartsv1.v1.devenv.Devenv`.
+
+.. literalinclude:: ../examples/modelartsv1/find_devenv_instance.py
+   :lines: 15-24
+
+Start Devenv Instance
+^^^^^^^^^^^^^^^^^^^^^
+
+This interface is used to start a devenv instance by
+id or an instance of class.
+:class:`~otcextensions.sdk.modelartsv1.v1.devenv.Devenv`.
+
+.. literalinclude:: ../examples/modelartsv1/start_devenv_instance.py
+   :lines: 15-22
+
+Stop Devenv Instance
+^^^^^^^^^^^^^^^^^^^^
+
+This interface is used to stop a devenv instance by
+id or an instance of class.
+:class:`~otcextensions.sdk.modelartsv1.v1.devenv.Devenv`.
+
+.. literalinclude:: ../examples/modelartsv1/stop_devenv_instance.py
+   :lines: 15-22
+
+Delete Devenv Instance
+^^^^^^^^^^^^^^^^^^^^^^
+
+This interface is used to delete a devenv instance by ID
+or an instance of class.
+:class:`~otcextensions.sdk.modelartsv1.v1.devenv.Devenv`.
+
+.. literalinclude:: ../examples/modelartsv1/delete_devenv_instance.py
+   :lines: 15-21
+
+
+ModelArts Service
+-----------------
+
+List Services
+^^^^^^^^^^^^^
+
+This interface is used to query modelarts services list.
+:class:`~otcextensions.sdk.modelartsv1.v1.service.Service`.
+
+.. literalinclude:: ../examples/modelartsv1/list_services.py
+   :lines: 15-21
+
+Create Service
+^^^^^^^^^^^^^^
+
+This interface is used to create a modelarts service with
+parameters.
+:class:`~otcextensions.sdk.modelartsv1.v1.service.Service`.
+
+.. literalinclude:: ../examples/modelartsv1/create_service.py
+   :lines: 15-45
+
+Get Service
+^^^^^^^^^^^
+
+This interface is used to get a service by ID or an instance of class.
+:class:`~otcextensions.sdk.modelartsv1.v1.service.Service`.
+
+.. literalinclude:: ../examples/modelartsv1/get_service.py
+   :lines: 15-22
+
+Find Service
+^^^^^^^^^^^^
+
+This interface is used to find a service by Id or name.
+:class:`~otcextensions.sdk.modelartsv1.v1.service.Service`.
+
+.. literalinclude:: ../examples/modelartsv1/find_service.py
+   :lines: 15-22
+
+Start Service
+^^^^^^^^^^^^^
+
+This interface is used to start a Service by Id or an instance of class.
+:class:`~otcextensions.sdk.modelartsv1.v1.service.Service`.
+
+.. literalinclude:: ../examples/modelartsv1/start_service.py
+   :lines: 15-24
+
+Stop Service
+^^^^^^^^^^^^
+
+This interface is used to stop a service by Id or an instance of class.
+:class:`~otcextensions.sdk.modelartsv1.v1.service.Service`.
+
+.. literalinclude:: ../examples/modelartsv1/stop_service.py
+   :lines: 15-24
+
+Delete Service
+^^^^^^^^^^^^^^
+
+This interface is used to delete a service by Id or an instance of class.
+:class:`~otcextensions.sdk.modelartsv1.v1.service.Service`.
+
+.. literalinclude:: ../examples/modelartsv1/delete_service.py
+   :lines: 15-23
+
+
+ModelArts Model
+-----------------
+
+List Models
+^^^^^^^^^^^
+
+This interface is used to query models list.
+:class:`~otcextensions.sdk.modelartsv1.v1.model.Model`.
+
+.. literalinclude:: ../examples/modelartsv1/list_models.py
+   :lines: 15-21
+
+Create Model
+^^^^^^^^^^^^
+
+This interface is used to create a model with parameters.
+:class:`~otcextensions.sdk.modelartsv1.v1.model.Model`.
+
+.. literalinclude:: ../examples/modelartsv1/create_model.py
+   :lines: 15-85
+
+Get Model
+^^^^^^^^^
+
+This interface is used to get a model by ID or an instance of class.
+:class:`~otcextensions.sdk.modelartsv1.v1.model.Model`.
+
+.. literalinclude:: ../examples/modelartsv1/get_model.py
+   :lines: 15-22
+
+Find Model
+^^^^^^^^^^
+
+This interface is used to find a model by Id or name.
+:class:`~otcextensions.sdk.modelartsv1.v1.model.Model`.
+
+.. literalinclude:: ../examples/modelartsv1/find_model.py
+   :lines: 15-22
+
+Delete Model
+^^^^^^^^^^^^
+
+This interface is used to delete a model by Id or an instance of class.
+:class:`~otcextensions.sdk.modelartsv1.v1.model.Model`.
+
+.. literalinclude:: ../examples/modelartsv1/delete_model.py
+   :lines: 15-23
+
+
+ModelArts Training Job
+----------------------
+
+List Training Jobs
+^^^^^^^^^^^^^^^^^^
+
+This interface is used to query training jobs list.
+:class:`~otcextensions.sdk.modelartsv1.v1.training_job.TrainingJob`.
+
+.. literalinclude:: ../examples/modelartsv1/list_training_jobs.py
+   :lines: 15-21
+
+Create Training Job
+^^^^^^^^^^^^^^^^^^^
+
+This interface is used to create a training job with parameters.
+:class:`~otcextensions.sdk.modelartsv1.v1.training_job.TrainingJob`.
+
+.. literalinclude:: ../examples/modelartsv1/create_training_job.py
+   :lines: 15-48
+
+Delete Training Job
+^^^^^^^^^^^^^^^^^^^
+
+This interface is used to delete a training job by Id or an instance of class.
+:class:`~otcextensions.sdk.modelartsv1.v1.training_job.TrainingJob`.
+
+.. literalinclude:: ../examples/modelartsv1/delete_training_job.py
+   :lines: 15-22

doc/source/sdk/proxies/index.rst

@@ -25,6 +25,7 @@ Service Proxies
    Key Management Service (KMS) <kms>
    Log Tank Service (LTS) <lts>
    MapReduce Service (MRS) <mrs>
+   Modelarts Service (ModelArts) <modelarts>
    Network Address Translation (NAT) <nat>
    Object Block Storage (OBS) <obs>
    Relational Database Service RDS V1 (RDSv1) <rds_v1>