Updated landing readme with warning and redirect
This commit is contained in:
annatisch
GitHub
Родитель
836f30af03
Коммит
e17e43cbb3
201
README.rst
201
README.rst
|
|
@ -2,6 +2,21 @@
|
||||||
Azure Batch Apps Blender Sample
|
Azure Batch Apps Blender Sample
|
||||||
===============================
|
===============================
|
||||||
|
|
||||||
|
Warning - Code currently being re-written
|
||||||
|
==========================================
|
||||||
|
|
||||||
|
This sample is based on the now-deprecated Azure Batch Apps service. The Blender sample is currently being re-written to work directly against
|
||||||
|
`Azure Batch <https://azure.microsoft.com/en-us/services/batch/>`_.
|
||||||
|
This updated version of the code can be accessed in the following fork while it is under-going development:
|
||||||
|
`<https://github.com/annatisch/azure-batch-apps-blender/tree/dev/>`_.
|
||||||
|
|
||||||
|
Please check the issues forum for guidance on using the in-development code and to report any bugs.
|
||||||
|
|
||||||
|
|
||||||
|
Summary
|
||||||
|
=======
|
||||||
|
|
||||||
|
|
||||||
Microsoft Azure Batch Apps is an Azure service offering on-demand capacity for compute-intensive workloads.
|
Microsoft Azure Batch Apps is an Azure service offering on-demand capacity for compute-intensive workloads.
|
||||||
This sample uses the Azure Batch Apps SDK and the Azure Batch Apps Python client to show how
|
This sample uses the Azure Batch Apps SDK and the Azure Batch Apps Python client to show how
|
||||||
one could set up a cloud-based rendering platform using Blender.
|
one could set up a cloud-based rendering platform using Blender.
|
||||||
|
|
@ -32,165 +47,6 @@ Blender is well suited to individuals and small studios who benefit from its uni
|
||||||
For more information and to download Blender, visit `blender.org <http://www.blender.org>`_.
|
For more information and to download Blender, visit `blender.org <http://www.blender.org>`_.
|
||||||
|
|
||||||
|
|
||||||
Set up
|
|
||||||
======
|
|
||||||
|
|
||||||
In order to build the projects you will need to have the following tools:
|
|
||||||
|
|
||||||
- `Visual Studio <http://www.visualstudio.com/>`_
|
|
||||||
- `Microsoft Azure Batch Apps Cloud SDK <http://www.nuget.org/packages/Microsoft.Azure.Batch.Apps.Cloud/>`_
|
|
||||||
- `Python Tools for Visual Studio <http://pytools.codeplex.com/>`_
|
|
||||||
- `Azure Batch Apps Python Client and it's required packages <https://github.com/Azure/azure-batch-apps-python>`_
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Part 1. Blender.Cloud
|
|
||||||
======================
|
|
||||||
|
|
||||||
This project builds a cloud assembly for running rendering jobs using Blender.
|
|
||||||
A "cloud assembly" is a zip file containing an application-specific DLL with logic for splitting
|
|
||||||
jobs into tasks, and for executing each of those tasks. In this sample, we split the job into
|
|
||||||
a task for each frame to be rendered, and execute each task by running the blender.exe program.
|
|
||||||
The cloud assembly goes hand in hand with an "application image", a zip file
|
|
||||||
containing the program or programs to be executed. In this sample, we have used Blender and
|
|
||||||
ImageMagick in the application image.
|
|
||||||
|
|
||||||
|
|
||||||
Building the Cloud Assembly
|
|
||||||
---------------------------
|
|
||||||
|
|
||||||
To build the cloud assembly zip file:
|
|
||||||
|
|
||||||
1. Build the Blender.Cloud project.
|
|
||||||
2. Open the output folder of the Blender.Cloud project.
|
|
||||||
3. Select all the DLLs (and optionally PDB files) in the output folder.
|
|
||||||
4. Right-click and choose Send To > Compressed Folder.
|
|
||||||
|
|
||||||
|
|
||||||
Building the Application Image
|
|
||||||
-------------------------------
|
|
||||||
|
|
||||||
The application image contains the following applications:
|
|
||||||
|
|
||||||
- `Blender <http://www.blender.org/download/>`_. The application we want to cloud-enable.
|
|
||||||
It is easiest in this scenario to download as a zip rather than the installer.
|
|
||||||
- `ImageMagick <http://www.imagemagick.org/script/binary-releases.php#windows>`_. (Optional) Tool for creating preview thumbnails
|
|
||||||
of the rendered frames. Locate the portable Win32 static build.
|
|
||||||
|
|
||||||
To build the application image zip file:
|
|
||||||
|
|
||||||
1. Open `www.blender.org/download <http://www.blender.org/download/>`_.
|
|
||||||
2. Locate the 64bit zip download for the latest Blender release. `Direct download of 2.73 here <http://mirror.cs.umn.edu/blender.org/release/Blender2.73/blender-2.73-windows64.zip>`_.
|
|
||||||
3. Extract the subfolder (blender-2.7x-windows64) to a location of choice and rename it 'Blender'.
|
|
||||||
4. Open `www.imagemagick.org/script/binary-releases.php#windows <http://www.imagemagick.org/script/binary-releases.php#windows>`_
|
|
||||||
5. Locate and download the portable Win32 static build. It is important to use the portable build!
|
|
||||||
6. Extract the subfolder (ImageMagick-6.x.x) next to the earlier 'Blender' directory, and rename it to 'ImageMagick'.
|
|
||||||
7. Select both the 'Blender' and 'ImageMagick' directories, right-click and choose Send To > Compressed Folder.
|
|
||||||
8. Rename the resulting zip file to Blender.zip
|
|
||||||
|
|
||||||
The final application image zip file should have the following structure::
|
|
||||||
|
|
||||||
Blender.zip
|
|
||||||
|
|
|
||||||
| -- Blender
|
|
||||||
| |
|
|
||||||
| | -- blender.exe
|
|
||||||
| | -- 2.7x directory
|
|
||||||
| | -- other Blender components
|
|
||||||
|
|
|
||||||
| -- ImageMagick
|
|
||||||
|
|
|
||||||
| -- convert.exe
|
|
||||||
| -- other ImageMagick components
|
|
||||||
|
|
||||||
|
|
||||||
Uploading the Application to Your Batch Apps Service
|
|
||||||
-----------------------------------------------------
|
|
||||||
|
|
||||||
1. Open the Azure management portal (manage.windowsazure.com).
|
|
||||||
2. Select Batch Services in the left-hand menu.
|
|
||||||
3. Select your account in the list and click "Manage Batch Apps" to open the Batch Apps management
|
|
||||||
portal. Your Batch Apps Service should be displayed, or you can navigate to it using the Services left-hand menu option.
|
|
||||||
4. Choose the Manage Applications tab.
|
|
||||||
5. Click New Application.
|
|
||||||
6. Under "Select and upload a cloud assembly", choose your cloud assembly zip file and click Upload.
|
|
||||||
7. Under "Select and upload an application image," choose your application image zip file and click Upload.
|
|
||||||
(Be sure to leave the version as "default".)
|
|
||||||
8. Click Done.
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Part 2. Blender.Client
|
|
||||||
=======================
|
|
||||||
|
|
||||||
Now that the Blender rendering service is configured in Batch Apps, we need a way to submit Blender files
|
|
||||||
to be rendered.
|
|
||||||
The sample client is an Addon for Blender written in Python, that can be used on multiple platforms.
|
|
||||||
|
|
||||||
Python Setup
|
|
||||||
-------------
|
|
||||||
|
|
||||||
The Addon requires some additional Python packages in order to run.
|
|
||||||
By default, Blender is shipped with its own Python environment, so it's into this environment that these
|
|
||||||
packages will need to be installed.
|
|
||||||
There are several approaches one could take:
|
|
||||||
|
|
||||||
- Run the included dependency_check.py script within Blender. This is an experimental script to conveniently
|
|
||||||
download and unpack the required modules into Blenders Python environment. To execute, run the following
|
|
||||||
command from a terminal/command line with administrator privileges::
|
|
||||||
|
|
||||||
>> blender.exe -b -P dependency_check.py
|
|
||||||
|
|
||||||
- If there is already an installation of Python 3.4 on the machine, one can use pip to install the required
|
|
||||||
packages, choosing the Blender bundled Python environment as the target directory for the installation. Note that by
|
|
||||||
installing azure-batch-apps first, all the remaining packages will be installed automatically as dependencies::
|
|
||||||
|
|
||||||
>> pip install --target "Blender Foundation/blender/2.7x/python/lib/site-packages" azure-batch-apps
|
|
||||||
|
|
||||||
- Download the packages directly from `pypi.python.org <http://pypi.python.org>`_. Extract their module subfolders and copy them into the
|
|
||||||
Blender bundled Python environment::
|
|
||||||
|
|
||||||
Destination: ~/Blender Foundation/blender/2.7x/python/lib/site-packages
|
|
||||||
|
|
||||||
The required packages are the following:
|
|
||||||
|
|
||||||
- `Batch Apps Python Client <https://pypi.python.org/pypi/azure-batch-apps>`_
|
|
||||||
- `Keyring <https://pypi.python.org/pypi/keyring>`_
|
|
||||||
- `OAuthLib <https://pypi.python.org/pypi/oauthlib>`_
|
|
||||||
- `Requests-OAuthLib <https://pypi.python.org/pypi/requests-oauthlib>`_
|
|
||||||
- Note: additional package `Requests <https://pypi.python.org/pypi/requests>`_ already comes bundled with Blender.
|
|
||||||
|
|
||||||
The Blender site-packages folder should look like this when complete::
|
|
||||||
|
|
||||||
site-packages
|
|
||||||
|
|
|
||||||
| -- batchapps
|
|
||||||
| |
|
|
||||||
| | -- __init__.py
|
|
||||||
| | -- other batchapps components
|
|
||||||
|
|
|
||||||
| -- keyring
|
|
||||||
| |
|
|
||||||
| | -- __init__.py
|
|
||||||
| | -- other keyring components
|
|
||||||
|
|
|
||||||
| -- oauthlib
|
|
||||||
| |
|
|
||||||
| | -- __init__.py
|
|
||||||
| | -- other oauthlib components
|
|
||||||
|
|
|
||||||
| -- requests (bundled by default)
|
|
||||||
| |
|
|
||||||
| | -- __init__.py
|
|
||||||
| | -- other requests components
|
|
||||||
|
|
|
||||||
| -- requests_oauthlib
|
|
||||||
| |
|
|
||||||
| | -- __init__.py
|
|
||||||
| | -- other requests_oauthlib components
|
|
||||||
|
|
|
||||||
| -- Other installed modules (e.g. numpy)
|
|
||||||
|
|
||||||
|
|
||||||
Building and Installing the Addon
|
Building and Installing the Addon
|
||||||
----------------------------------
|
----------------------------------
|
||||||
|
|
@ -231,32 +87,7 @@ The authentication configuration settings of the file can also be overridden in
|
||||||
7. Once saved, restart Blender for the changes to take effect.
|
7. Once saved, restart Blender for the changes to take effect.
|
||||||
|
|
||||||
|
|
||||||
Authentication
|
|
||||||
---------------
|
|
||||||
|
|
||||||
To run this addon you will need:
|
|
||||||
|
|
||||||
- Your Batch Apps service URL
|
|
||||||
- Unattended account credentials for your Batch Apps service
|
|
||||||
|
|
||||||
1. Open the Azure management portal (manage.windowsazure.com).
|
|
||||||
2. Select Batch Services in the left-hand menu.
|
|
||||||
3. Select your account in the list and click "Manage Batch Apps" to open the Batch Apps management
|
|
||||||
portal. Your Batch Apps Service should be displayed, or you can navigate to it using the Services left-hand menu option.
|
|
||||||
4. Copy the service URL from the page and paste it into the 'Service URL' field in the Blender User Preferences.
|
|
||||||
5. Click the Unattended Account button at the bottom of the page.
|
|
||||||
6. Copy the Account ID from the page and paste it into the 'Unattended Account' field in the Blender User Preferences.
|
|
||||||
7. Below the Account Keys list, select the desired duration and click the Add Key button.
|
|
||||||
Copy the generated key and paste it into the 'Unattended Key' field in the Blender User Preferences.
|
|
||||||
NOTE: the generated key will be shown only once! If you accidentally close the page
|
|
||||||
before copying the key, just reopen it and add a new key.
|
|
||||||
|
|
||||||
|
|
||||||
Addon Documentation
|
|
||||||
--------------------
|
|
||||||
|
|
||||||
The Addon User Guide can be found `here <http://dl.windowsazure.com/batchapps/blender/user_guide.html>`_.
|
|
||||||
Auto generated Sphinx documentation for the Addon code can be found `here <http://dl.windowsazure.com/batchapps/blender/batchapps_blender.html>`_.
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
|
||||||
Загрузка…
Ссылка в новой задаче