Some checks failed
check agents / check (push) Failing after 12s
azure-discovery, aws-discovery and gcp-discovery collect read-only metadata on servers, workloads, Kubernetes clusters, networks, data stores, policies and provider recommendations. Credentials arrive per call from the vault. Replies are paged, scrubbed of secrets and anonymised, and throttled calls back off. cloud-knowledge searches each provider's Well-Architected guidance from fixed lists only, so no customer detail can leave the platform. Adds shared skills, the render and test tooling, a public Python Dockerfile until the hardened base image is reachable, the customer access guide, the implementation plan and the Vault Service platform issue. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
80 lines
3.4 KiB
YAML
80 lines
3.4 KiB
YAML
# Hyperscaler Well-Architected guidance, for later workflows such as ALZ-F05 Target Architecture.
|
|
# Holds Kyndryl's access, never a customer's. Store its connection tenant-wide. Queries come from fixed lists only.
|
|
|
|
server_id: cloud-knowledge
|
|
name: Cloud Knowledge
|
|
description: Well-Architected guidance from each hyperscaler's own knowledge server, searched by fixed pillar and
|
|
topic.
|
|
version: 0.1.1
|
|
port: 8114
|
|
verify_tool: cloud_check_connection
|
|
shared_code:
|
|
- _common/tool_support.py
|
|
- _common/knowledge_support.py
|
|
extra_requirements:
|
|
- boto3==1.43.122
|
|
connection_fields:
|
|
- name: aws_access_key_id
|
|
title: AWS access key ID
|
|
description: Kyndryl's identity for the AWS MCP Server.
|
|
required: false
|
|
secret: false
|
|
- name: aws_secret_access_key
|
|
title: AWS secret access key
|
|
description: Its secret key.
|
|
required: false
|
|
secret: true
|
|
- name: google_api_key
|
|
title: Google API key
|
|
description: Kyndryl's key for the Developer Knowledge API.
|
|
required: false
|
|
secret: true
|
|
tools:
|
|
- name: cloud_check_connection
|
|
display_name: Check connection
|
|
description: Test that the knowledge servers answer. Sends no customer data.
|
|
parameters: []
|
|
ai_implementation: |
|
|
async def cloud_check_connection(arguments: Dict[str, Any]) -> Dict[str, Any]:
|
|
results = {}
|
|
connection = get_connection()
|
|
for provider in KNOWLEDGE_SERVERS:
|
|
try:
|
|
await _knowledge_tools(provider, connection)
|
|
results[provider] = "reachable"
|
|
except Exception as error:
|
|
results[provider] = type(error).__name__
|
|
return {"ok": all(v == "reachable" for v in results.values()), "message": json.dumps(results)}
|
|
- name: cloud_search_well_architected
|
|
display_name: Search Well-Architected guidance
|
|
description: Search a hyperscaler's Well-Architected guidance by pillar and topic. Both come from fixed lists,
|
|
so no customer detail can leave the platform.
|
|
parameters:
|
|
- name: provider
|
|
type: string
|
|
description: azure, aws or gcp.
|
|
required: true
|
|
- name: pillar
|
|
type: string
|
|
description: reliability, security, cost, operations, performance or sustainability.
|
|
required: true
|
|
- name: topic
|
|
type: string
|
|
description: One of the fixed topics; an invalid value lists them.
|
|
required: true
|
|
ai_implementation: |
|
|
async def cloud_search_well_architected(arguments: Dict[str, Any]) -> Dict[str, Any]:
|
|
provider, pillar, topic = arguments.get("provider"), arguments.get("pillar"), arguments.get("topic")
|
|
if provider not in KNOWLEDGE_SERVERS:
|
|
return _refuse("invalid_argument", "provider must be azure, aws or gcp")
|
|
if pillar not in KNOWLEDGE_PILLARS:
|
|
return _refuse("invalid_argument", "pillar must be one of: " + ", ".join(KNOWLEDGE_PILLARS))
|
|
if topic not in KNOWLEDGE_TOPICS:
|
|
return _refuse("invalid_argument", "topic must be one of: " + ", ".join(KNOWLEDGE_TOPICS))
|
|
query = f"{KNOWLEDGE_SERVERS[provider]['framework']} {pillar} {topic}"
|
|
try:
|
|
results = await _knowledge_search(provider, get_connection(), query)
|
|
except Exception as error:
|
|
return _upstream_failed(provider, error)
|
|
return {"success": True, "data": {"provider": provider, "pillar": pillar, "topic": topic, "results": results, "collected_at": _collected_at(), "evidence_ref": _evidence_ref("cloud_search_well_architected", arguments, results)}}
|