Stay organized with collections
Save and categorize content based on your preferences.
Cloud Build features
This page describes some optional configurations to build the
Cortex Framework Data Foundation with Cloud Build features,
such as building in a specific region
or using a private worker pool. These configurations offer significant benefits
in terms of data privacy, performance, security, and customization. The best
approach depends on your specific requirements and the nature of your application.
Build in a specific region
Regional Building ensures that your data remains within a specific geographic
region. This can help you to comply with local data privacy regulation,
availability and latency reduction. For more information, see
Cloud Build locations.
To run the deployment through a specific region,
add the substitution parameter _CLOUD_BUILD_REGION with --region bash parameter,
as the following command:
gcloud builds submit \
--config=./cloudbuild.yaml \
--substitutions=_GCS_BUCKET=BUCKET_FOR_LOGS,_CLOUD_BUILD_REGION=REGION \
--region=REGION
Replace the following:
BUCKET_FOR_LOGS with the bucket name for
the logs.REGION with the region for your deployment.
For more information about available regions, see
Geography and regions.
Build with a private worker pool
Using a private worker pool
provides a more secure environment for your builds.
Private pools are private, dedicated pools of workers that offer
customization over the build environment, including the ability to access
resources in a private network. For more information, see
Private pools overview.
To configure a private worker, add the _WORKER_POOL_NAME with corresponding
_CLOUD_BUILD_REGION parameter, as the following command:
gcloud builds submit \
--config=./cloudbuild.yaml
--substitutions=_GCS_BUCKET=BUCKET_FOR_LOGS,_WORKER_POOL_NAME='projects/SOURCE_PROJECT/locations/us-central1/workerPools/YOUR_WORKER_POOL_NAME',_CLOUD_BUILD_REGION=REGION \
--region=REGION
Replace the following:
BUCKET_FOR_LOGS with the bucket name for
the logs.SOURCE_PROJECT with the source project for
Cortex Framework Data Foundation deployment.YOUR_WORKER_POOL_NAME with the name for your
worker pool.REGION with the region for your deployment.
For more information about available regions, see
Geography and regions.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-25 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-25 UTC."],[[["\u003cp\u003eThis document outlines optional configurations for building the Cortex Framework Data Foundation using Cloud Build features to enhance data privacy, performance, security, and customization.\u003c/p\u003e\n"],["\u003cp\u003eDeployments can be run through a user-created service account, specified with the \u003ccode\u003e_BUILD_ACCOUNT\u003c/code\u003e substitution parameter, allowing a deployment process without direct resource access.\u003c/p\u003e\n"],["\u003cp\u003eYou can ensure data remains within a specific geographical boundary by utilizing the regional building feature, activated by adding the \u003ccode\u003e_CLOUD_BUILD_REGION\u003c/code\u003e substitution parameter with the \u003ccode\u003e--region\u003c/code\u003e parameter.\u003c/p\u003e\n"],["\u003cp\u003eA private worker pool can be configured for a more secure build environment, enabling customization and access to private network resources, by specifying the \u003ccode\u003e_WORKER_POOL_NAME\u003c/code\u003e and \u003ccode\u003e_CLOUD_BUILD_REGION\u003c/code\u003e parameters.\u003c/p\u003e\n"]]],[],null,["# Cloud Build features\n====================\n\nThis page describes some optional configurations to build the\nCortex Framework Data Foundation with Cloud Build features,\nsuch as building in a specific region\nor using a private worker pool. These configurations offer significant benefits\nin terms of data privacy, performance, security, and customization. The best\napproach depends on your specific requirements and the nature of your application.\n\nBuild in a specific region\n--------------------------\n\nRegional Building ensures that your data remains within a specific geographic\nregion. This can help you to comply with local data privacy regulation,\navailability and latency reduction. For more information, see\n[Cloud Build locations](/build/docs/locations).\n\nTo run the deployment through a specific [region](/build/docs/locations#selecting_the_region),\nadd the substitution parameter `_CLOUD_BUILD_REGION` with `--region` bash parameter,\nas the following command: \n\n gcloud builds submit \\\n --config=./cloudbuild.yaml \\\n --substitutions=_GCS_BUCKET=\u003cvar translate=\"no\"\u003eBUCKET_FOR_LOGS\u003c/var\u003e,_CLOUD_BUILD_REGION=\u003cvar translate=\"no\"\u003eREGION\u003c/var\u003e \\\n --region=\u003cvar translate=\"no\"\u003eREGION\u003c/var\u003e\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eBUCKET_FOR_LOGS\u003c/var\u003e with the bucket name for the logs.\n- \u003cvar translate=\"no\"\u003eREGION\u003c/var\u003e with the region for your deployment. For more information about available regions, see [Geography and regions](/docs/geography-and-regions).\n\nBuild with a private worker pool\n--------------------------------\n\nUsing a [private worker pool](/build/docs/private-pools/run-builds-in-private-pool)\nprovides a more secure environment for your builds.\nPrivate pools are private, dedicated pools of workers that offer\ncustomization over the build environment, including the ability to access\nresources in a private network. For more information, see\n[Private pools overview](/build/docs/private-pools/private-pools-overview).\n\nTo configure a private worker, add the `_WORKER_POOL_NAME` with corresponding\n`_CLOUD_BUILD_REGION` parameter, as the following command: \n\n gcloud builds submit \\\n --config=./cloudbuild.yaml\n --substitutions=_GCS_BUCKET=\u003cvar translate=\"no\"\u003eBUCKET_FOR_LOGS\u003c/var\u003e,_WORKER_POOL_NAME='projects/\u003cvar translate=\"no\"\u003eSOURCE_PROJECT\u003c/var\u003e/locations/us-central1/workerPools/\u003cvar translate=\"no\"\u003eYOUR_WORKER_POOL_NAME\u003c/var\u003e',_CLOUD_BUILD_REGION=\u003cvar translate=\"no\"\u003eREGION\u003c/var\u003e \\\n --region=\u003cvar translate=\"no\"\u003eREGION\u003c/var\u003e\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eBUCKET_FOR_LOGS\u003c/var\u003e with the bucket name for the logs.\n- \u003cvar translate=\"no\"\u003eSOURCE_PROJECT\u003c/var\u003e with the source project for Cortex Framework Data Foundation deployment.\n- \u003cvar translate=\"no\"\u003eYOUR_WORKER_POOL_NAME\u003c/var\u003e with the name for your worker pool.\n- \u003cvar translate=\"no\"\u003eREGION\u003c/var\u003e with the region for your deployment. For more information about available regions, see [Geography and regions](/docs/geography-and-regions)."]]
