AWS deadline-cloud documentation change
Summary
Restructured documentation for testing Maya render jobs, adding separate sections for local testing with Open Job Description CLI and testing on Deadline Cloud, with updated commands and parameters.
Security assessment
The changes are purely instructional and procedural, focusing on testing workflows and command syntax. There is no mention of security vulnerabilities, patches, or security features. The changes include parameter adjustments (ErrorOnArnoldLicenseFail) and channel configuration, which are functional improvements rather than security fixes.
Diff
diff --git a/deadline-cloud/latest/developerguide/submit-render-maya-mtoa.md b/deadline-cloud/latest/developerguide/submit-render-maya-mtoa.md index 2c210c14b..b71058978 100644 --- a//deadline-cloud/latest/developerguide/submit-render-maya-mtoa.md +++ b//deadline-cloud/latest/developerguide/submit-render-maya-mtoa.md @@ -5 +5 @@ -# Test your package with a Maya render job +Testing locallyTesting on Deadline Cloud @@ -7 +7 @@ -After you have the Maya 2025 and MtoA packages built, you can submit jobs to render with the package. The [ turntable with Maya/Arnold](https://github.com/aws-deadline/deadline-cloud-samples/tree/mainline/job_bundles/turntable_with_maya_arnold) job bundle sample renders an animation with Maya and Arnold. This sample also uses FFmpeg to encode a video. You can add the conda-forge channel to the list of default `CondaChannels` in your conda queue environment to provide a source for the `ffmpeg` package. +# Test your packages with a Maya render job @@ -9 +9 @@ After you have the Maya 2025 and MtoA packages built, you can submit jobs to ren -From the `job_bundles` directory in your git clone of [deadline-cloud-samples](https://github.com/aws-deadline/deadline-cloud-samples), run the following command. +After you build the Maya, MtoA, and `maya-openjd` packages, you can test them with a render job. The Deadline Cloud samples repository contains a [turntable with Maya/Arnold](https://github.com/aws-deadline/deadline-cloud-samples/tree/mainline/job_bundles/turntable_with_maya_arnold) job bundle that renders an animation using Maya and Arnold. The job bundle also uses FFmpeg to encode a video, which is available from the `conda-forge` channel. @@ -10,0 +11 @@ From the `job_bundles` directory in your git clone of [deadline-cloud-samples](h +## Testing locally @@ -12 +13,6 @@ From the `job_bundles` directory in your git clone of [deadline-cloud-samples](h - deadline bundle submit turntable_with_maya_arnold +You can run the job template on your workstation using the [Open Job Description CLI](https://github.com/OpenJobDescription/openjd-cli#readme). Install the CLI with `pip`. + + + pip install openjd-cli + +From the `job_bundles` directory in the samples repository, run the following command. The `ErrorOnArnoldLicenseFail=false` parameter tells Arnold to render with watermarks instead of failing when no license is available. @@ -14 +19,0 @@ From the `job_bundles` directory in your git clone of [deadline-cloud-samples](h -You can use the Deadline Cloud monitor to track the progress of your job: @@ -16 +21,6 @@ You can use the Deadline Cloud monitor to track the progress of your job: - 1. In the monitor, select the task for the job you submitted, then select the option to view the log. + openjd run turntable_with_maya_arnold/template.yaml \ + --environment ../queue_environments/conda_queue_env_pyrattler.yaml \ + -p CondaPackages="maya maya-mtoa maya-openjd ffmpeg" \ + -p CondaChannels="file://$HOME/my-conda-channel conda-forge" \ + -p ErrorOnArnoldLicenseFail=false \ + -p FrameRange=1-5 @@ -18 +28 @@ You can use the Deadline Cloud monitor to track the progress of your job: - 2. On the right side of the log view, select the **Launch Conda** session action. +The `--environment` option applies the conda queue environment, which creates a conda virtual environment with the packages specified in `CondaPackages`. The `CondaChannels` parameter includes both the local channel for your custom packages and `conda-forge` for `ffmpeg`. If you published to an Amazon S3 channel instead of a local channel, replace the `file://` path with your `s3://` channel URL. @@ -19,0 +30 @@ You can use the Deadline Cloud monitor to track the progress of your job: +When the job completes, the rendered output is in the `turntable_with_maya_arnold/output/` directory. @@ -20,0 +32 @@ You can use the Deadline Cloud monitor to track the progress of your job: +## Testing on Deadline Cloud @@ -21,0 +34,4 @@ You can use the Deadline Cloud monitor to track the progress of your job: +After you configure your production queue to use the Amazon S3 conda channel, submit the render job to Deadline Cloud. Add the `conda-forge` channel to the `CondaChannels` parameter in your conda queue environment to provide a source for `ffmpeg` and the Python dependencies that the adaptor requires. From the `job_bundles` directory in the samples repository, run the following command. + + + deadline bundle submit turntable_with_maya_arnold @@ -23 +39 @@ You can use the Deadline Cloud monitor to track the progress of your job: -You can see that the action searched for maya and maya-mtoa in the conda channels configured for the queue environment, and that it found the packages in the S3 channel. +Use the Deadline Cloud monitor to track the progress of the job. In the monitor, select the task for the job and choose **View logs**. Select the **Launch Conda** session action to verify that the `maya`, `maya-mtoa`, and `maya-openjd` packages were found in the Amazon S3 channel.