Skip to content

crossplane-contrib/provider-styra

Repository files navigation

provider-styra

Crossplane provider for Styra DAS. The provider built from this repository can be installed into a Crossplane control plane or run seperately. It provides the following features:

  • Extension of the K8s API with CRDs to represent Styra objects as K8s resources
  • Controllers to provision these resources into a Styra instance
  • Implementations of Crossplane's portable resource abstractions, enabling Styra resources to fulfill a user's general need for cloud services

Getting Started and Documentation

For getting start with Crossplane setup installation and deployment, see the official documentation.

To use provider-styra

  1. Setup a new Styra instance or use an existing one
  2. Create a new Styra API token, and store it in a K8s secret
kubectl create secret generic provider-styra-creds --from-literal=token=$API_TOKEN -n crossplane-system
  1. Create a new ProviderConfig resource with a references to this secret

You are now ready to create resources as described in examples.

Contributing

provider-styra is a community driven project and we welcome contributions. See the Crossplane Contributing guidelines to get started.

Adding New Resource

New resources can be added by defining the required types in apis and the controllers pkg/controllers/.

To generate the CRD YAML files run

make generate

Report a Bug

For filing bugs, suggesting improvements, or requesting new features, please open an issue.

Contact

Please use the following to reach members of the community:

Governance and Owners

provider-styra is run according to the same Governance and Ownership structure as the core Crossplane project.

Code of Conduct

provider-styra adheres to the same Code of Conduct as the core Crossplane project.

Licensing

provider-styra is under the Apache 2.0 license.

Usage

To run the project

make run

To run all tests:

make test

To build the project

make build

To list all available options

make help

See more

Code generation

See CODE_GENERATION.md