provider-nebius is a Crossplane provider for
Nebius AI Cloud, built with
Upjet and backed by the
nebius/nebius
Terraform provider.
It exposes XRM-conformant managed resources that let you manage Nebius
infrastructure — VPCs, compute instances, managed Kubernetes clusters, IAM,
storage, and more — directly from Kubernetes or Upbound. Every resource is
available in two flavors: cluster-scoped (*.nebius.upbound.io) and
namespaced (*.nebius.m.upbound.io).
The provider authenticates using an identity.type selected on the
ProviderConfig, combined with credentials read from the referenced Secret.
Two modes are supported:
Authenticate using a static IAM token.
{
"token": "<IAM token>"
}Authenticate using a service-account key.
{
"account_id": "<service account ID>",
"public_key_id": "<public key ID>",
"private_key": "<private key>"
}apiVersion: pkg.crossplane.io/v1
kind: Provider
metadata:
name: provider-nebius
spec:
package: xpkg.upbound.io/upbound/provider-nebius:v1.0.0Replace <IAM token> with your actual value, or use the ServiceAccount
fields shown above instead.
apiVersion: v1
kind: Secret
metadata:
name: nebius-creds
namespace: upbound-system
type: Opaque
stringData:
creds: |
{
"token": "<IAM token>"
}apiVersion: nebius.upbound.io/v1beta1
kind: ProviderConfig
metadata:
name: default
spec:
projectID: project-e00example
identity:
type: Token
credentials:
source: Secret
secretRef:
name: nebius-creds
namespace: upbound-system
key: credsapiVersion: vpc.nebius.upbound.io/v1beta1
kind: Network
metadata:
name: example
spec:
forProvider:
name: example
parentId: project-e00example
providerConfigRef:
name: defaultMore examples for each resource are available under examples/cluster/
and examples/namespaced/.
| Field | Required | Description |
|---|---|---|
spec.identity.type |
Yes | Authentication mode: Token or ServiceAccount |
spec.projectID |
No | Default Nebius project ID for project-parented resources; can be overridden per-resource via spec.forProvider.parentId |
spec.credentials.source |
Yes | One of Secret, InjectedIdentity, Environment, Filesystem |
spec.credentials.secretRef |
When source=Secret | Reference to the credentials Secret |
spec.reconciliationPolicy |
No | Rate-limiting policy for reconciliation |
make generateThis runs the Upjet code generator against the pinned nebius/nebius
Terraform provider schema and docs, and writes the generated APIs,
controllers, and CRDs for both the cluster-scoped and namespaced variants.
make runmake e2ePlease open an issue for bug reports, feature requests, or questions.