## aiSSEMBLE™ Foundation Versioning
[](https://pypi.org/project/aissemble-foundation-versioning-service/)


This module contains the implementation for the aiSSEMBLE versioning service. The service provides the ability to version artifacts produced by a Solution Baseline machine-learning pipeline, and uses Maven to package and deploy the artifacts to Nexus.
### Model Versioning
The following GET endpoint is provided for model versioning: `/version/model/{run_id}`
`run_id` is the unique training run identifier assigned to an MLflow training experiment. The versioning service currently only supports models that have been trained using the MLflow implementation of a Solution Baseline machine-learning pipeline. It will package the training run artifacts produced by MLflow and the model artifacts produced when saving through MLflow.
The following environment variables are required for model versioning:
- `MLFLOW_TRACKING_URI`: the MLflow tracking URI path specified in the training pipeline. This is where MLflow saves the training run artifacts.
- `MODEL_DIRECTORY`: The model directory path specified in the training pipeline. This is where the training pipeline saves the trained models.
- `NEXUS_SERVER`: The Nexus server to use to push the versioned artifact to. The credentials for this server must be provided in the Maven settings.xml file.
### Example
Below is a basic example of how to leverage the versioning service:
- Extending the baseline docker image to include Nexus credentials
```dockerfile
FROM boozallen/aissemble-versioning:${VERSION_AISSEMBLE}
COPY /custom/maven/settings/containing/nexus/credentials.xml /root/.m2/settings.xml
```
- Docker-compose configurations for running the service
```
example-versioning-service:
image: my-extended-versioning-service-image:latest
ports:
- '80:80'
environment:
MLFLOW_TRACKING_URI: /path/to/mlflow/tracking/uri
MODEL_DIRECTORY: /path/to/saved/models
NEXUS_SERVER: http://nexus-server:port
```
- Note: By default Versioning requires authorization and therefore must have security services running (policy-decision-point).
- Add the following to the above docker-compose file:
```
policy-decision-point:
image: ${CONTAINER_REGISTRY}boozallen/policy-decision-point-docker:latest
hostname: policy-decision-point
container_name: policy-decision-point
ports:
- "8780:8080"
- "9700:9000"
```
- Add an `auth.properties` file to your docker image with the following content.
```
pdp_host_url=http://policy-decision-point:8080/api/pdp
```
- Then add the following environment variable that points to your properties file.
`ENV KRAUSENING_BASE /path/to/auth.properties/file`
- To disable authorization you can add the following to the `auth.properties` file: `is_authorization_enabled = False`.
Raw data
{
"_id": null,
"home_page": null,
"name": "aissemble-foundation-versioning-service",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": null,
"author": "aiSSEMBLE Baseline Community",
"author_email": "aissemble@bah.com",
"download_url": "https://files.pythonhosted.org/packages/51/c0/50683329271f576cfc579d162893e2f330a8973e1f9223f43c2c7cedf328/aissemble_foundation_versioning_service-1.11.1.tar.gz",
"platform": null,
"description": "## aiSSEMBLE™ Foundation Versioning\n\n[](https://pypi.org/project/aissemble-foundation-versioning-service/)\n\n\n\nThis module contains the implementation for the aiSSEMBLE versioning service. The service provides the ability to version artifacts produced by a Solution Baseline machine-learning pipeline, and uses Maven to package and deploy the artifacts to Nexus.\n\n### Model Versioning\n\nThe following GET endpoint is provided for model versioning: `/version/model/{run_id}`\n\n`run_id` is the unique training run identifier assigned to an MLflow training experiment. The versioning service currently only supports models that have been trained using the MLflow implementation of a Solution Baseline machine-learning pipeline. It will package the training run artifacts produced by MLflow and the model artifacts produced when saving through MLflow.\n\nThe following environment variables are required for model versioning:\n- `MLFLOW_TRACKING_URI`: the MLflow tracking URI path specified in the training pipeline. This is where MLflow saves the training run artifacts.\n- `MODEL_DIRECTORY`: The model directory path specified in the training pipeline. This is where the training pipeline saves the trained models.\n- `NEXUS_SERVER`: The Nexus server to use to push the versioned artifact to. The credentials for this server must be provided in the Maven settings.xml file.\n\n### Example\n\nBelow is a basic example of how to leverage the versioning service:\n- Extending the baseline docker image to include Nexus credentials\n ```dockerfile\n FROM boozallen/aissemble-versioning:${VERSION_AISSEMBLE}\n\n COPY /custom/maven/settings/containing/nexus/credentials.xml /root/.m2/settings.xml\n ```\n- Docker-compose configurations for running the service\n ```\n example-versioning-service:\n image: my-extended-versioning-service-image:latest\n ports:\n - '80:80'\n environment:\n MLFLOW_TRACKING_URI: /path/to/mlflow/tracking/uri\n MODEL_DIRECTORY: /path/to/saved/models\n NEXUS_SERVER: http://nexus-server:port\n ```\n- Note: By default Versioning requires authorization and therefore must have security services running (policy-decision-point).\n - Add the following to the above docker-compose file:\n ```\n policy-decision-point:\n image: ${CONTAINER_REGISTRY}boozallen/policy-decision-point-docker:latest\n hostname: policy-decision-point\n container_name: policy-decision-point\n ports:\n - \"8780:8080\"\n - \"9700:9000\"\n ```\n - Add an `auth.properties` file to your docker image with the following content.\n ```\n pdp_host_url=http://policy-decision-point:8080/api/pdp\n ```\n - Then add the following environment variable that points to your properties file. \n `ENV KRAUSENING_BASE /path/to/auth.properties/file`\n - To disable authorization you can add the following to the `auth.properties` file: `is_authorization_enabled = False`.\n",
"bugtrack_url": null,
"license": null,
"summary": null,
"version": "1.11.1",
"project_urls": null,
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "5f3b6e4f9f68574185e3ac0e02d374ebb4dfa8ff232d03b43623ae631b6fd404",
"md5": "90a3d36795b76822e5e8da39e65acd8e",
"sha256": "4325814ffe2047f37e775b36b4d39d8284c3b3b8ac0c9f1722f4bdebbd55bce3"
},
"downloads": -1,
"filename": "aissemble_foundation_versioning_service-1.11.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "90a3d36795b76822e5e8da39e65acd8e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 8824,
"upload_time": "2025-02-10T17:33:54",
"upload_time_iso_8601": "2025-02-10T17:33:54.519841Z",
"url": "https://files.pythonhosted.org/packages/5f/3b/6e4f9f68574185e3ac0e02d374ebb4dfa8ff232d03b43623ae631b6fd404/aissemble_foundation_versioning_service-1.11.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "51c050683329271f576cfc579d162893e2f330a8973e1f9223f43c2c7cedf328",
"md5": "7da487d4103db491ae32f8ff3d111e3d",
"sha256": "b68ab9f01daacac14b9d80908253ced2f3807d5f5a2129702fde24e33c5d5e30"
},
"downloads": -1,
"filename": "aissemble_foundation_versioning_service-1.11.1.tar.gz",
"has_sig": false,
"md5_digest": "7da487d4103db491ae32f8ff3d111e3d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 7485,
"upload_time": "2025-02-10T17:33:55",
"upload_time_iso_8601": "2025-02-10T17:33:55.660156Z",
"url": "https://files.pythonhosted.org/packages/51/c0/50683329271f576cfc579d162893e2f330a8973e1f9223f43c2c7cedf328/aissemble_foundation_versioning_service-1.11.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-10 17:33:55",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "aissemble-foundation-versioning-service"
}