The highest tagged major version is
README
¶
ORC: openstack-resource-controller
Description
openstack-resource-controller, or ORC, is a Kubernetes API for declarative management of OpenStack resources. By fully controlling the order of OpenStack operations, it allows consumers to easily create, manage, and reproduce complex deployments. ORC aims to be easily consumed both directly by users, and by higher level controllers. ORC aims to cover all OpenStack APIs which can be expressed declaratively.
ORC is based on Gophercloud, the OpenStack Go SDK.
Maturity
ORC is deployed and used in production environments and is notably a dependency of Cluster API's OpenStack provider.
The Kubernetes API is currently v1alpha1. The core API patterns are stable and
we do not anticipate major structural changes, but the API is still evolving as
we add new controllers and features. We do not have a timeline for graduation to
v1beta1.
ORC versioning follows semver: there will be no breaking changes within a major release.
How You Can Contribute
We welcome contributions of all kinds! See CONTRIBUTING.md for details on how to get started, including setting up a development environment, submitting pull requests, and becoming a maintainer.
Join us on Kubernetes Slack in #gophercloud. Visit slack.k8s.io for an invitation.
Getting Started
Prerequisites
ORC heavily uses CEL validations and thus depends on Kubernetes v1.29 or above.
Installation
To install a released version of ORC, the simplest is probably to use the provided install.yaml file:
export ORC_RELEASE="https://github.com/k-orc/openstack-resource-controller/releases/latest/download/install.yaml"
kubectl apply --server-side -f $ORC_RELEASE
You may later uninstall ORC using the same install.yaml file:
kubectl delete -f $ORC_RELEASE
Usage
Supported OpenStack resources
| controller | 1.x (EOL) | 2.x | main |
|---|---|---|---|
| addressscope | ✔ | ✔ | |
| application credential | ◐ | ◐ | |
| domain | ✔ | ✔ | |
| endpoint | ◐ | ✔ | |
| flavor | ✔ | ✔ | |
| floating ip | ◐ | ◐ | |
| group | ✔ | ✔ | |
| image | ✔ | ✔ | ✔ |
| keypair | ◐ | ◐ | |
| limit | ✔ | ||
| network | ◐ | ◐ | |
| port | ◐ | ◐ | |
| project | ◐ | ◐ | |
| region | ◐ | ||
| registered limits | ◐ | ||
| role | ✔ | ✔ | |
| router | ◐ | ◐ | |
| security group (incl. rule) | ✔ | ✔ | |
| server | ◐ | ◐ | |
| server group | ✔ | ✔ | |
| service | ✔ | ✔ | |
| share network | ◐ | ||
| subnet | ◐ | ◐ | |
| trunk | ✔ | ✔ | |
| user | ◐ | ◐ | |
| volume | ◐ | ◐ | |
| volume type | ◐ | ◐ |
✔: mostly implemented
◐: partially implemented
License
Copyright The ORC Authors.
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Directories
¶
| Path | Synopsis |
|---|---|
|
v1alpha1
Package v1alpha1 contains API Schema definitions for the openstack v1alpha1 API group +kubebuilder:object:generate=true +groupName=openstack.k-orc.cloud +k8s:openapi-gen=true
|
Package v1alpha1 contains API Schema definitions for the openstack v1alpha1 API group +kubebuilder:object:generate=true +groupName=openstack.k-orc.cloud +k8s:openapi-gen=true |
|
cmd
|
|
|
kustomizeconfig-generator
command
Command kustomizeconfig-generator generates examples/components/kustomizeconfig/kustomizeconfig.yaml from the ORC API types.
|
Command kustomizeconfig-generator generates examples/components/kustomizeconfig/kustomizeconfig.yaml from the ORC API types. |
|
manager
command
|
|
|
models-schema
command
|
|
|
resource-generator
command
|
|
|
scaffold-controller
command
|
|
|
internal
|
|
|
controllers/generic/resync
Package resync provides helpers for determining the effective resync period for ORC controllers, implementing the configuration resolution hierarchy.
|
Package resync provides helpers for determining the effective resync period for ORC controllers, implementing the configuration resolution hierarchy. |
|
osclients/mock
Package mock is a generated GoMock package.
|
Package mock is a generated GoMock package. |
|
pkg
|
|
|
clients/clientset/clientset/fake
This package has the automatically generated fake clientset.
|
This package has the automatically generated fake clientset. |
|
clients/clientset/clientset/scheme
This package contains the scheme of the automatically generated clientset.
|
This package contains the scheme of the automatically generated clientset. |
|
clients/clientset/clientset/typed/api/v1alpha1
This package has the automatically generated typed clients.
|
This package has the automatically generated typed clients. |
|
clients/clientset/clientset/typed/api/v1alpha1/fake
Package fake has the automatically generated clients.
|
Package fake has the automatically generated clients. |
|
test
|
|