README
¶
Controller Integration Tests
Primarily this folder contains integration tests, used to exercise the ASO controller to ensure that everything works properly. This includes tests for resources as well as for the controller itself. (This folder also contains resource registration, in controller_resources.go and controller_resources_gen.go).
Test authorship
Always write a new test to exercise a new resource or resource version.
We shouldn't assume that, just because an earlier version worked fine, the new version will as well. There's always the possibility that the way a particular resource provider behaves with a new version will require a change in the was we interact with it.
As a minimum, we want to have tests for
- the latest
stableversion of the resource; - the prior
stableversion of the resource; and - the latest
previewversion of the resource.
Given that we don't want to have to maintain tests for every version of every resource, and each additional test makes our CI test suite take longer, consider removing tests for older versions of resources when we add tests for newer versions. This is a judgment call, and we recommend discussion with the team first.
File naming
Test files should use the following naming convention:
<group>_<subject>_<scenario>_<version>_test.go
Where:
<group>is the Kubernetes resource group under test.
Lowercase. Use the actual name of the group, e.g.compute, notCompute, norMicrosoft.Compute.<subject>is the subject under test, often a kubernetes resource within the given group.
Lowercase. Use the actual name of the resource, e.g.account, notAccount.<scenario>is a (very) short indicator of the test scenario.
Typically camelCase for clarity. Common scenarios includecrud(short for Create, Read, Update and Delete).<version>is the Kubernetes API version of the resource under test.
Use the actual version in full, not a contraction, and not the API version, e.g.v1api20210101, notv1alpha1or2021-01-01.
All parts are optional and should be omitted if they don't apply to the tests in that file.
If you have tests for multiple scenarios, create multiple files, one per scenario.
Some examples to illustrate:
| Filename | Breakdown | Check that ASO can correctly |
|---|---|---|
batch_account_crud_v1api20210101_test.go |
Group: batch Subject: account Scenario: crud Version: v1api20210101 |
create and maintain a Batch Account. |
servicebus_namespace_basicSkuCrud_v1api20210101preview_test.go |
Group: servicebus Subject: namespace Scenario: basicSkuCrud Version: v1api20210101preview |
create and maintain a Basic SKU ServiceBus Namespace. |
servicebus_namespace_standardSkuCrud_v1api20211101_test.go |
Group: servicebus Subject: namespace Scenario: standardSkuCrud Version: v1api20211101 |
create and maintain a Standard SKU ServiceBus Namespace. |
documentdb_databaseaccount_mongodbCrud_v1api20210515_test.go |
Group: documentdb Subject: databaseaccount Scenario: mongodbCrud Version: v1api20210515 |
create and maintain a CosmosDB account in MongoDB mode |
documentdb_databaseaccount_secretsFromAzure_v1api20210515_test.go |
Group: documentdb Subject: databaseaccount Scenario: cosmosdbSecretsFromAzure Version: v1api20210515 |
Test that ASO can correctly create maintain a CosmosDB Database Account and retrieve access keys from Azure. |
Additional Notes
The filename for all resource tests should include the version of the primary resource under test, even if it's currently the only version of the resource. We want to avoid the need to rename existing tests when a new version of a resource is imported. Never assume that ASO will only ever have one version of any specific resource.
Why use group-kind-version and not group-version-kind for naming? Not every test is strictly related to a specific resource version. Ordering of parts is based on making it as easy as possible for future maintainers to scan the list of test files and find the one they want.
Documentation
¶
Overview ¶
Code generated by azure-service-operator-codegen. DO NOT EDIT. Copyright (c) Microsoft Corporation. Licensed under the MIT license.
Index ¶
- func CreateScheme() *runtime.Scheme
- func GetKnownStorageTypes(mgr ctrl.Manager, armConnectionFactory arm.ARMConnectionFactory, ...) ([]*registration.StorageType, error)
- func GetKnownTypes() []client.Object
- func GetResourceExtensions(scheme *runtime.Scheme) (map[schema.GroupVersionKind]genruntime.ResourceExtension, error)
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func CreateScheme ¶
func GetKnownStorageTypes ¶
func GetKnownStorageTypes( mgr ctrl.Manager, armConnectionFactory arm.ARMConnectionFactory, credentialProvider identity.CredentialProvider, kubeClient kubeclient.Client, positiveConditions *conditions.PositiveConditionBuilder, options generic.Options, ) ([]*registration.StorageType, error)
func GetKnownTypes ¶
func GetResourceExtensions ¶
func GetResourceExtensions(scheme *runtime.Scheme) (map[schema.GroupVersionKind]genruntime.ResourceExtension, error)
GetResourceExtensions returns a map between resource and resource extension
Types ¶
This section is empty.
Source Files