feat: the solution architecture agent on the shared Execution engine
The reference agent's subject, cloud solution architecture, as an agent in the operating model agent's pattern: the Execution engine (from orchestration_engine) and one Workflow in app/solution_architecture, built for the settings and provider bundle by assembly.workflow_for. Copied from gcp_solution_architecture_agent at 8b397cd without its own engine: its role files, Skills, provider bundle, ADRs, vocabulary, scripts and evaluation datasets. The image takes the engine from a named build context and installs Terraform. It is called through the Orchestration engine, and its files are what the operating model agent digests. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
231
skills/vendor/google/google-cloud-solution-architecture/references/best-practices-guides.md
vendored
Normal file
231
skills/vendor/google/google-cloud-solution-architecture/references/best-practices-guides.md
vendored
Normal file
@@ -0,0 +1,231 @@
|
||||
# Product-specific best practices guides
|
||||
|
||||
| Product | Line hints |
|
||||
|---------|------------|
|
||||
| [Best practices covering multiple products](#multiple-products) | Lines 31-34 |
|
||||
| [AI Hypercomputer](#ai-hypercomputer) | Lines 35-38 |
|
||||
| [AlloyDB](#alloydb) | Lines 39-45 |
|
||||
| [Backup and Disaster Recovery (DR) Service](#backup-and-disaster-recovery-dr-service) | Lines 46-53 |
|
||||
| [BigQuery](#bigquery) | Lines 54-68 |
|
||||
| [Cloud Armor](#cloud-armor) | Lines 69-72 |
|
||||
| [Cloud Load Balancing](#cloud-load-balancing) | Lines 73-76 |
|
||||
| [Cloud Run](#cloud-run) | Lines 77-84 |
|
||||
| [Cloud Service Mesh](#cloud-service-mesh) | Lines 85-94 |
|
||||
| [Cloud SQL](#cloud-sql) | Lines 95-102 |
|
||||
| [Cloud Storage](#cloud-storage) | Lines 103-108 |
|
||||
| [Compute Engine](#compute-engine) | Lines 109-125 |
|
||||
| [Gemini Enterprise Agent Platform](#gemini-enterprise-agent-platform) | Lines 126-132 |
|
||||
| [Google Kubernetes Engine (GKE)](#google-kubernetes-engine-gke) | Lines 133-152 |
|
||||
| [Identity and Access Management (IAM)](#identity-and-access-management-iam) | Lines 153-162 |
|
||||
| [Managed Service for Apache Spark](#managed-service-for-apache-spark) | Lines 163-167 |
|
||||
| [Memorystore](#memorystore) | Lines 168-176 |
|
||||
| [Migration](#migration) | Lines 177-181 |
|
||||
| [Network Connectivity](#network-connectivity) | Lines 182-187 |
|
||||
| [Observability in Google Cloud](#observability-in-google-cloud) | Lines 188-196 |
|
||||
| [Pub/Sub](#pub-sub) | Lines 197-202 |
|
||||
| [Security Command Center](#security-command-center) | Lines 203-206 |
|
||||
| [Security](#security) | Lines 207-216 |
|
||||
| [Spanner](#spanner) | Lines 217-228 |
|
||||
| [Vertex AI](#vertex-ai) | Lines 229-232 |
|
||||
|
||||
## <a id="multiple-products"></a>Best practices covering multiple products
|
||||
|
||||
- https://docs.cloud.google.com/workload-manager/docs/reference/best-practices-general.md.txt
|
||||
|
||||
## <a id="ai-hypercomputer"></a>AI Hypercomputer
|
||||
|
||||
- https://docs.cloud.google.com/ai-hypercomputer/docs/networking-best-practices.md.txt
|
||||
|
||||
## <a id="alloydb"></a>AlloyDB
|
||||
|
||||
- https://docs.cloud.google.com/alloydb/docs/ai/best-practices-tuning-scann.md.txt
|
||||
- https://docs.cloud.google.com/alloydb/docs/auth-proxy/best-practices.md.txt
|
||||
- https://docs.cloud.google.com/alloydb/docs/import-export-best-practices.md.txt
|
||||
- https://docs.cloud.google.com/alloydb/docs/security-best-practices.md.txt
|
||||
|
||||
## <a id="backup-and-disaster-recovery-dr-service"></a>Backup and Disaster Recovery (DR) Service
|
||||
|
||||
- https://docs.cloud.google.com/backup-disaster-recovery/docs/concepts/backup-plan-policy-best-practices.md.txt
|
||||
- https://docs.cloud.google.com/backup-disaster-recovery/docs/concepts/best-practices-cyber-resilience.md.txt
|
||||
- https://docs.cloud.google.com/backup-disaster-recovery/docs/concepts/best-practices-ransomware.md.txt
|
||||
- https://docs.cloud.google.com/backup-disaster-recovery/docs/concepts/policy-specific-best-practices.md.txt
|
||||
- https://docs.cloud.google.com/backup-disaster-recovery/docs/create-plan/schedule-best-practices-at-a-glance.md.txt
|
||||
|
||||
## <a id="bigquery"></a>BigQuery
|
||||
|
||||
- https://docs.cloud.google.com/bigquery/docs/best-practices-costs.md.txt
|
||||
- https://docs.cloud.google.com/bigquery/docs/best-practices-for-multi-tenant-workloads-on-bigquery.md.txt
|
||||
- https://docs.cloud.google.com/bigquery/docs/best-practices-performance-compute.md.txt
|
||||
- https://docs.cloud.google.com/bigquery/docs/best-practices-performance-functions.md.txt
|
||||
- https://docs.cloud.google.com/bigquery/docs/best-practices-performance-nested.md.txt
|
||||
- https://docs.cloud.google.com/bigquery/docs/best-practices-performance-overview.md.txt
|
||||
- https://docs.cloud.google.com/bigquery/docs/best-practices-policy-tags.md.txt
|
||||
- https://docs.cloud.google.com/bigquery/docs/best-practices-row-level-security.md.txt
|
||||
- https://docs.cloud.google.com/bigquery/docs/best-practices-spatial-analysis.md.txt
|
||||
- https://docs.cloud.google.com/bigquery/docs/best-practices-storage.md.txt
|
||||
- https://docs.cloud.google.com/bigquery/docs/graph-query-best-practices.md.txt
|
||||
- https://docs.cloud.google.com/bigquery/docs/write-api-best-practices.md.txt
|
||||
|
||||
## <a id="cloud-armor"></a>Cloud Armor
|
||||
|
||||
- https://docs.cloud.google.com/armor/docs/best-practices.md.txt
|
||||
|
||||
## <a id="cloud-load-balancing"></a>Cloud Load Balancing
|
||||
|
||||
- https://docs.cloud.google.com/load-balancing/docs/https/http-load-balancing-best-practices.md.txt
|
||||
|
||||
## <a id="cloud-run"></a>Cloud Run
|
||||
|
||||
- https://docs.cloud.google.com/run/docs/configuring/jobs/gpu-best-practices.md.txt
|
||||
- https://docs.cloud.google.com/run/docs/configuring/networking-best-practices.md.txt
|
||||
- https://docs.cloud.google.com/run/docs/configuring/services/gpu-best-practices.md.txt
|
||||
- https://docs.cloud.google.com/run/docs/configuring/workerpools/gpu-best-practices.md.txt
|
||||
- https://docs.cloud.google.com/run/docs/tips/functions-best-practices.md.txt
|
||||
|
||||
## <a id="cloud-service-mesh"></a>Cloud Service Mesh
|
||||
|
||||
- https://docs.cloud.google.com/service-mesh/docs/canonical-service-best-practices.md.txt
|
||||
- https://docs.cloud.google.com/service-mesh/docs/istio-apis/security/best-practices.md.txt
|
||||
- https://docs.cloud.google.com/service-mesh/docs/istio-apis/security/egress-gateways-best-practices.md.txt
|
||||
- https://docs.cloud.google.com/service-mesh/docs/operate-and-maintain/scalability-best-practices.md.txt
|
||||
- https://docs.cloud.google.com/service-mesh/docs/security/anthos-service-mesh-security-best-practices.md.txt
|
||||
- https://docs.cloud.google.com/service-mesh/docs/security/best-practices.md.txt
|
||||
- https://docs.cloud.google.com/service-mesh/docs/security/egress-gateways-best-practices.md.txt
|
||||
|
||||
## <a id="cloud-sql"></a>Cloud SQL
|
||||
|
||||
- https://docs.cloud.google.com/sql/docs/best-practices.md.txt
|
||||
- https://docs.cloud.google.com/sql/docs/mysql/best-practices.md.txt
|
||||
- https://docs.cloud.google.com/sql/docs/postgres/best-practices.md.txt
|
||||
- https://docs.cloud.google.com/sql/docs/postgres/manage-memory-usage-best-practices.md.txt
|
||||
- https://docs.cloud.google.com/sql/docs/sqlserver/best-practices.md.txt
|
||||
|
||||
## <a id="cloud-storage"></a>Cloud Storage
|
||||
|
||||
- https://docs.cloud.google.com/storage/docs/best-practices-media-workload.md.txt
|
||||
- https://docs.cloud.google.com/storage/docs/best-practices.md.txt
|
||||
- https://docs.cloud.google.com/storage/docs/hns-buckets-best-practices.md.txt
|
||||
|
||||
## <a id="compute-engine"></a>Compute Engine
|
||||
|
||||
- https://docs.cloud.google.com/compute/docs/api/best-practices.md.txt
|
||||
- https://docs.cloud.google.com/compute/docs/connect/ssh-best-practices/auditing.md.txt
|
||||
- https://docs.cloud.google.com/compute/docs/connect/ssh-best-practices/credentials.md.txt
|
||||
- https://docs.cloud.google.com/compute/docs/connect/ssh-best-practices.md.txt
|
||||
- https://docs.cloud.google.com/compute/docs/connect/ssh-best-practices/login-access.md.txt
|
||||
- https://docs.cloud.google.com/compute/docs/connect/ssh-best-practices/network-access.md.txt
|
||||
- https://docs.cloud.google.com/compute/docs/disks/snapshot-best-practices.md.txt
|
||||
- https://docs.cloud.google.com/compute/docs/images/image-families-best-practices.md.txt
|
||||
- https://docs.cloud.google.com/compute/docs/images/image-management-best-practices.md.txt
|
||||
- https://docs.cloud.google.com/compute/docs/instances/best-practices-shared-reservations.md.txt
|
||||
- https://docs.cloud.google.com/compute/docs/instances/sql-server/best-practices.md.txt
|
||||
- https://docs.cloud.google.com/compute/docs/instances/windows/best-practices.md.txt
|
||||
- https://docs.cloud.google.com/compute/docs/instances/windows/windows-best-practices.md.txt
|
||||
- https://docs.cloud.google.com/compute/docs/nodes/sole-tenant-best-practices.md.txt
|
||||
|
||||
## <a id="gemini-enterprise-agent-platform"></a>Gemini Enterprise Agent Platform
|
||||
|
||||
- https://docs.cloud.google.com/gemini-enterprise-agent-platform/govern/policies/best-practices.md.txt
|
||||
- https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/capabilities/gemini-image-generation-best-practices.md.txt
|
||||
- https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/live-api/best-practices.md.txt
|
||||
- https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/video/best-practice.md.txt
|
||||
|
||||
## <a id="google-kubernetes-engine-gke"></a>Google Kubernetes Engine (GKE)
|
||||
|
||||
- https://docs.cloud.google.com/kubernetes-engine/docs/best-practices/batch-platform-on-gke.md.txt
|
||||
- https://docs.cloud.google.com/kubernetes-engine/docs/best-practices/enterprise-multitenancy.md.txt
|
||||
- https://docs.cloud.google.com/kubernetes-engine/docs/best-practices.md.txt
|
||||
- https://docs.cloud.google.com/kubernetes-engine/docs/best-practices/machine-learning/inference/autoscaling-tpu.md.txt
|
||||
- https://docs.cloud.google.com/kubernetes-engine/docs/best-practices/machine-learning/inference/autoscaling.md.txt
|
||||
- https://docs.cloud.google.com/kubernetes-engine/docs/best-practices/machine-learning/inference/batch-inference.md.txt
|
||||
- https://docs.cloud.google.com/kubernetes-engine/docs/best-practices/machine-learning/inference.md.txt
|
||||
- https://docs.cloud.google.com/kubernetes-engine/docs/best-practices/machine-learning/inference/llm-optimization.md.txt
|
||||
- https://docs.cloud.google.com/kubernetes-engine/docs/best-practices/networking.md.txt
|
||||
- https://docs.cloud.google.com/kubernetes-engine/docs/best-practices/optimize-ai-utilization.md.txt
|
||||
- https://docs.cloud.google.com/kubernetes-engine/docs/best-practices/rbac.md.txt
|
||||
- https://docs.cloud.google.com/kubernetes-engine/docs/best-practices/run-hpc.md.txt
|
||||
- https://docs.cloud.google.com/kubernetes-engine/docs/best-practices/scalability.md.txt
|
||||
- https://docs.cloud.google.com/kubernetes-engine/docs/best-practices/upgrading-clusters.md.txt
|
||||
- https://docs.cloud.google.com/kubernetes-engine/docs/concepts/best-practices-continuous-integration-delivery-kubernetes.md.txt
|
||||
- https://docs.cloud.google.com/kubernetes-engine/security/ai-security-best-practices.md.txt
|
||||
- https://docs.cloud.google.com/kubernetes-engine/docs/how-to/hardening-your-cluster.md.txt
|
||||
|
||||
## <a id="identity-and-access-management-iam"></a>Identity and Access Management (IAM)
|
||||
|
||||
- https://docs.cloud.google.com/iam/docs/best-practices-for-managing-service-account-keys.md.txt
|
||||
- https://docs.cloud.google.com/iam/docs/best-practices-for-using-service-accounts-in-deployment-pipelines.md.txt
|
||||
- https://docs.cloud.google.com/iam/docs/best-practices-for-using-workload-identity-federation.md.txt
|
||||
- https://docs.cloud.google.com/iam/docs/best-practices-service-accounts.md.txt
|
||||
- https://docs.cloud.google.com/iam/docs/best-practices-workforce-identity-federation.md.txt
|
||||
- https://docs.cloud.google.com/iam/docs/groups-best-practices.md.txt
|
||||
- https://docs.cloud.google.com/iam/docs/pam-best-practices.md.txt
|
||||
|
||||
## <a id="managed-service-for-apache-spark"></a>Managed Service for Apache Spark
|
||||
|
||||
- https://docs.cloud.google.com/managed-spark/docs/concepts/security-best-practices.md.txt
|
||||
- https://docs.cloud.google.com/managed-spark/docs/guides/best-practices.md.txt
|
||||
|
||||
## <a id="memorystore"></a>Memorystore
|
||||
|
||||
- https://docs.cloud.google.com/memorystore/docs/cluster/general-best-practices.md.txt
|
||||
- https://docs.cloud.google.com/memorystore/docs/memcached/best-practices.md.txt
|
||||
- https://docs.cloud.google.com/memorystore/docs/memcached/memory-management-best-practices.md.txt
|
||||
- https://docs.cloud.google.com/memorystore/docs/redis/general-best-practices.md.txt
|
||||
- https://docs.cloud.google.com/memorystore/docs/redis/memory-management-best-practices.md.txt
|
||||
- https://docs.cloud.google.com/memorystore/docs/valkey/general-best-practices.md.txt
|
||||
|
||||
## <a id="migration"></a>Migration
|
||||
|
||||
- https://docs.cloud.google.com/migrate/containers/docs/planning-best-practices.md.txt
|
||||
- https://docs.cloud.google.com/migrate/virtual-machines/docs/5.0/discover/migrating-vms-migrate-for-compute-engine-best-practices.md.txt
|
||||
|
||||
## <a id="network-connectivity"></a>Network Connectivity
|
||||
|
||||
- https://docs.cloud.google.com/network-connectivity/docs/interconnect/concepts/best-practices.md.txt
|
||||
- https://docs.cloud.google.com/network-connectivity/docs/router/concepts/best-practices.md.txt
|
||||
- https://docs.cloud.google.com/network-connectivity/docs/vpn/concepts/best-practices.md.txt
|
||||
|
||||
## <a id="observability-in-google-cloud"></a>Observability in Google Cloud
|
||||
|
||||
- https://docs.cloud.google.com/stackdriver/docs/managed-prometheus/best-practices/config.md.txt
|
||||
- https://docs.cloud.google.com/stackdriver/docs/managed-prometheus/best-practices/ingest-and-query.md.txt
|
||||
- https://docs.cloud.google.com/stackdriver/docs/managed-prometheus/best-practices/multi-tenant.md.txt
|
||||
- https://docs.cloud.google.com/stackdriver/docs/managed-prometheus/best-practices/rule-alert-mgd.md.txt
|
||||
- https://docs.cloud.google.com/stackdriver/docs/managed-prometheus/best-practices/rule-alert-self.md.txt
|
||||
- https://docs.cloud.google.com/stackdriver/docs/managed-prometheus/best-practices/unusual-configs.md.txt
|
||||
|
||||
## <a id="pub-sub"></a>Pub/Sub
|
||||
|
||||
- https://docs.cloud.google.com/pubsub/docs/metrics-autoscaling-best-practices.md.txt
|
||||
- https://docs.cloud.google.com/pubsub/docs/publish-best-practices.md.txt
|
||||
- https://docs.cloud.google.com/pubsub/docs/subscribe-best-practices.md.txt
|
||||
|
||||
## <a id="security-command-center"></a>Security Command Center
|
||||
|
||||
- https://docs.cloud.google.com/security-command-center/docs/cryptomining-detection-best-practices.md.txt
|
||||
|
||||
## <a id="security"></a>Security
|
||||
|
||||
- https://docs.cloud.google.com/docs/security/security-best-practices-catalog/agents-applications.md.txt
|
||||
- https://docs.cloud.google.com/docs/security/security-best-practices-catalog/data-management.md.txt
|
||||
- https://docs.cloud.google.com/docs/security/security-best-practices-catalog.md.txt
|
||||
- https://docs.cloud.google.com/docs/security/security-best-practices-catalog/infrastructure.md.txt
|
||||
- https://docs.cloud.google.com/docs/security/security-best-practices-catalog/recommended-iam-groups.md.txt
|
||||
- https://docs.cloud.google.com/docs/security/security-best-practices-catalog/secure-enterprise-foundations.md.txt
|
||||
- https://docs.cloud.google.com/docs/security/security-best-practices-catalog/tools-inference.md.txt
|
||||
|
||||
## <a id="spanner"></a>Spanner
|
||||
|
||||
- https://docs.cloud.google.com/spanner/docs/best-practices-gaming-database.md.txt
|
||||
- https://docs.cloud.google.com/spanner/docs/dml-best-practices.md.txt
|
||||
- https://docs.cloud.google.com/spanner/docs/graph/algorithm-best-practices.md.txt
|
||||
- https://docs.cloud.google.com/spanner/docs/graph/best-practices-designing-schema.md.txt
|
||||
- https://docs.cloud.google.com/spanner/docs/graph/best-practices-tuning-queries.md.txt
|
||||
- https://docs.cloud.google.com/spanner/docs/schema-updates-best-practices.md.txt
|
||||
- https://docs.cloud.google.com/spanner/docs/sql-best-practices.md.txt
|
||||
- https://docs.cloud.google.com/spanner/docs/vector-index-best-practices.md.txt
|
||||
- https://docs.cloud.google.com/spanner/docs/vector-search-best-practices.md.txt
|
||||
|
||||
## <a id="vertex-ai"></a>Vertex AI
|
||||
|
||||
- https://docs.cloud.google.com/vertex-ai/docs/featurestore/best-practices.md.txt
|
||||
Reference in New Issue
Block a user