# crossplane-contrib/provider-upjet-aws architecture

> Architecture diagram of the GitHub repository crossplane-contrib/provider-upjet-aws, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/crossplane-contrib/provider-upjet-aws
- Repository: https://github.com/crossplane-contrib/provider-upjet-aws

## Overview

Provider Upjet-AWS exposes Crossplane managed resources for AWS. The principal workflow is a user declaring a managed resource, the provider reconciling it, and AWS state being observed or changed; the sampled EKS ClusterAuth controller also refreshes connection details. The tree shows extensive cluster-scoped and namespaced APIs and specialized controllers. Several runtime entry points and generated resource controllers were not sampled, so their connections are shown only as unverified where necessary; README statements support the product-level scope.

Main entry points: [`internal/controller/cluster`](https://github.com/crossplane-contrib/provider-upjet-aws/tree/main/internal/controller/cluster) (Cluster reconcilers), [`internal/controller/cluster/eks/clusterauth/controller.go`](https://github.com/crossplane-contrib/provider-upjet-aws/blob/main/internal/controller/cluster/eks/clusterauth/controller.go) (ClusterAuth controller), [`internal/controller/namespaced/eks/clusterauth/controller.go`](https://github.com/crossplane-contrib/provider-upjet-aws/blob/main/internal/controller/namespaced/eks/clusterauth/controller.go) (Namespaced auth), [`apis/cluster`](https://github.com/crossplane-contrib/provider-upjet-aws/tree/main/apis/cluster) (Cluster APIs)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Managed resource APIs"]
  node_cluster_api["Cluster APIs"]
  node_namespaced_api["Namespaced APIs"]
end

subgraph group_runtime["Reconciliation runtime"]
  node_provider_runtime["Provider runtime"]
  node_cluster_recon["Cluster reconcilers"]
  node_namespaced_recon["Namespaced reconcilers"]
  node_clients["AWS clients"]
end

subgraph group_config["Provider configuration"]
  node_external_names["External-name rules<br/>[externalname.go]"]
  node_diff_utils["Diff utilities<br/>[set_rehash.go]"]
  node_creds_cache["Credentials cache<br/>[creds_cache.go]"]
end

subgraph group_special["Special controllers"]
  node_cluster_auth["ClusterAuth controller<br/>[controller.go]"]
  node_namespaced_auth["Namespaced auth<br/>[controller.go]"]
  node_codepipeline_setup["CodePipeline setup"]
  node_datapipeline_setup["Data Pipeline setup"]
end

node_user(("Crossplane user"))
node_aws{{"Amazon AWS"}}

node_user -->|"declares resources"| node_cluster_api
node_user -->|"declares resources"| node_namespaced_api
node_cluster_api -.->|"reconciled by"| node_cluster_recon
node_namespaced_api -.->|"reconciled by"| node_namespaced_recon
node_provider_runtime -.->|"registers controllers"| node_cluster_recon
node_provider_runtime -.->|"registers controllers"| node_namespaced_recon
node_cluster_recon -.->|"manages resources"| node_aws
node_namespaced_recon -.->|"manages resources"| node_aws
node_cluster_auth -->|"calls EKS and STS"| node_aws
node_namespaced_auth -->|"calls EKS and STS"| node_aws
node_cluster_auth -->|"uses client types"| node_clients
node_namespaced_auth -->|"uses client types"| node_clients
node_cluster_auth -->|"reconciles ClusterAuth"| node_cluster_api
node_namespaced_auth -->|"reconciles ClusterAuth"| node_namespaced_api
node_codepipeline_setup -->|"registers controllers"| node_cluster_recon
node_datapipeline_setup -->|"registers controller"| node_cluster_recon

click node_cluster_api "https://github.com/crossplane-contrib/provider-upjet-aws/tree/main/apis/cluster"
click node_namespaced_api "https://github.com/crossplane-contrib/provider-upjet-aws/tree/main/apis/namespaced"
click node_provider_runtime "https://github.com/crossplane-contrib/provider-upjet-aws/tree/main/cmd/provider"
click node_cluster_recon "https://github.com/crossplane-contrib/provider-upjet-aws/tree/main/internal/controller/cluster"
click node_namespaced_recon "https://github.com/crossplane-contrib/provider-upjet-aws/tree/main/internal/controller/namespaced"
click node_clients "https://github.com/crossplane-contrib/provider-upjet-aws/tree/main/internal/clients"
click node_external_names "https://github.com/crossplane-contrib/provider-upjet-aws/blob/main/config/externalname.go"
click node_diff_utils "https://github.com/crossplane-contrib/provider-upjet-aws/blob/main/config/diffutils/set_rehash.go"
click node_creds_cache "https://github.com/crossplane-contrib/provider-upjet-aws/blob/main/internal/clients/creds_cache.go"
click node_cluster_auth "https://github.com/crossplane-contrib/provider-upjet-aws/blob/main/internal/controller/cluster/eks/clusterauth/controller.go"
click node_namespaced_auth "https://github.com/crossplane-contrib/provider-upjet-aws/blob/main/internal/controller/namespaced/eks/clusterauth/controller.go"
click node_codepipeline_setup "https://github.com/crossplane-contrib/provider-upjet-aws/blob/main/internal/controller/cluster/zz_codepipeline_setup.go"
click node_datapipeline_setup "https://github.com/crossplane-contrib/provider-upjet-aws/blob/main/internal/controller/cluster/zz_datapipeline_setup.go"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cluster_api,node_namespaced_api,node_user toneBlue
class node_provider_runtime,node_cluster_recon,node_namespaced_recon,node_clients toneAmber
class node_external_names,node_diff_utils,node_creds_cache toneMint
class node_cluster_auth,node_namespaced_auth,node_codepipeline_setup,node_datapipeline_setup toneRose
class node_aws toneIndigo
```

## Components

### Managed resource APIs

- [Cluster APIs](https://github.com/crossplane-contrib/provider-upjet-aws/tree/main/apis/cluster): `apis/cluster`
- [Namespaced APIs](https://github.com/crossplane-contrib/provider-upjet-aws/tree/main/apis/namespaced): `apis/namespaced`

### Reconciliation runtime

- [Provider runtime](https://github.com/crossplane-contrib/provider-upjet-aws/tree/main/cmd/provider): `cmd/provider`
- [Cluster reconcilers](https://github.com/crossplane-contrib/provider-upjet-aws/tree/main/internal/controller/cluster): `internal/controller/cluster`
- [Namespaced reconcilers](https://github.com/crossplane-contrib/provider-upjet-aws/tree/main/internal/controller/namespaced): `internal/controller/namespaced`
- [AWS clients](https://github.com/crossplane-contrib/provider-upjet-aws/tree/main/internal/clients): `internal/clients`

### Provider configuration

- [External-name rules](https://github.com/crossplane-contrib/provider-upjet-aws/blob/main/config/externalname.go): `config/externalname.go`
- [Diff utilities](https://github.com/crossplane-contrib/provider-upjet-aws/blob/main/config/diffutils/set_rehash.go): `config/diffutils/set_rehash.go`
- [Credentials cache](https://github.com/crossplane-contrib/provider-upjet-aws/blob/main/internal/clients/creds_cache.go): `internal/clients/creds_cache.go`

### Special controllers

- [ClusterAuth controller](https://github.com/crossplane-contrib/provider-upjet-aws/blob/main/internal/controller/cluster/eks/clusterauth/controller.go): `internal/controller/cluster/eks/clusterauth/controller.go`
- [Namespaced auth](https://github.com/crossplane-contrib/provider-upjet-aws/blob/main/internal/controller/namespaced/eks/clusterauth/controller.go): `internal/controller/namespaced/eks/clusterauth/controller.go`
- [CodePipeline setup](https://github.com/crossplane-contrib/provider-upjet-aws/blob/main/internal/controller/cluster/zz_codepipeline_setup.go): `internal/controller/cluster/zz_codepipeline_setup.go`
- [Data Pipeline setup](https://github.com/crossplane-contrib/provider-upjet-aws/blob/main/internal/controller/cluster/zz_datapipeline_setup.go): `internal/controller/cluster/zz_datapipeline_setup.go`

### Other components

- **Crossplane user**
- **Amazon AWS**

## Connections

- Crossplane user → Cluster APIs: declares resources (evidence: `README.md`)
- Crossplane user → Namespaced APIs: declares resources (evidence: `README.md`)
- Cluster APIs → Cluster reconcilers: reconciled by (evidence: `internal/controller/cluster/eks/clusterauth/controller.go`)
- Namespaced APIs → Namespaced reconcilers: reconciled by (evidence: `internal/controller/namespaced/eks/clusterauth/controller.go`)
- Provider runtime → Cluster reconcilers: registers controllers
- Provider runtime → Namespaced reconcilers: registers controllers
- Cluster reconcilers → Amazon AWS: manages resources
- Namespaced reconcilers → Amazon AWS: manages resources
- ClusterAuth controller → Amazon AWS: calls EKS and STS (evidence: `internal/controller/cluster/eks/clusterauth/controller.go`)
- Namespaced auth → Amazon AWS: calls EKS and STS (evidence: `internal/controller/namespaced/eks/clusterauth/controller.go`)
- ClusterAuth controller → AWS clients: uses client types (evidence: `internal/controller/cluster/eks/clusterauth/controller.go`)
- Namespaced auth → AWS clients: uses client types (evidence: `internal/controller/namespaced/eks/clusterauth/controller.go`)
- ClusterAuth controller → Cluster APIs: reconciles ClusterAuth (evidence: `internal/controller/cluster/eks/clusterauth/controller.go`)
- Namespaced auth → Namespaced APIs: reconciles ClusterAuth (evidence: `internal/controller/namespaced/eks/clusterauth/controller.go`)
- CodePipeline setup → Cluster reconcilers: registers controllers (evidence: `internal/controller/cluster/zz_codepipeline_setup.go`)
- Data Pipeline setup → Cluster reconcilers: registers controller (evidence: `internal/controller/cluster/zz_datapipeline_setup.go`)
