## 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": "https://github.com/boozallen/aissemble",
"name": "aissemble-foundation-versioning-service",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": null,
"author": "aiSSEMBLE Baseline Community",
"author_email": "aissemble@bah.com",
"download_url": "https://files.pythonhosted.org/packages/37/02/4979f9a4951ef9b9ab021a248f622d5a0ce91ddd11b34e983775341bb189/aissemble_foundation_versioning_service-2.0.0.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": "Apache-2.0",
"summary": null,
"version": "2.0.0",
"project_urls": {
"Documentation": "https://boozallen.github.io/aissemble",
"Homepage": "https://github.com/boozallen/aissemble",
"Repository": "https://github.com/boozallen/aissemble"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "02df4fef09af6aca5961c4834426c96827b662a5e17a3145458bd892f2c89e7e",
"md5": "db184d764ad72bacf917ebe6d32a8f8a",
"sha256": "9f7e64fd887eaa60e7967d307d5ccbf822b76fffbc412cf7cf1892cbe99d1b01"
},
"downloads": -1,
"filename": "aissemble_foundation_versioning_service-2.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "db184d764ad72bacf917ebe6d32a8f8a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 10738,
"upload_time": "2025-10-08T16:31:18",
"upload_time_iso_8601": "2025-10-08T16:31:18.291248Z",
"url": "https://files.pythonhosted.org/packages/02/df/4fef09af6aca5961c4834426c96827b662a5e17a3145458bd892f2c89e7e/aissemble_foundation_versioning_service-2.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "37024979f9a4951ef9b9ab021a248f622d5a0ce91ddd11b34e983775341bb189",
"md5": "bc678f734dfbcadf4b876238659b6409",
"sha256": "144da89853e0f352ab8e87ebda586a2d1a0600eddcdbabddb23763be9e42f92f"
},
"downloads": -1,
"filename": "aissemble_foundation_versioning_service-2.0.0.tar.gz",
"has_sig": false,
"md5_digest": "bc678f734dfbcadf4b876238659b6409",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 8475,
"upload_time": "2025-10-08T16:31:19",
"upload_time_iso_8601": "2025-10-08T16:31:19.215455Z",
"url": "https://files.pythonhosted.org/packages/37/02/4979f9a4951ef9b9ab021a248f622d5a0ce91ddd11b34e983775341bb189/aissemble_foundation_versioning_service-2.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-08 16:31:19",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "boozallen",
"github_project": "aissemble",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "aissemble-foundation-versioning-service"
}
JSON
