/
configuration.go
178 lines (155 loc) · 7.06 KB
/
configuration.go
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
/*
Copyright 2019 The Knative 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.
*/
package v1beta1
import (
"context"
"fmt"
corev1 "k8s.io/api/core/v1"
"knative.dev/pkg/apis/duck"
"knative.dev/pkg/test/logging"
v1 "knative.dev/serving/pkg/apis/serving/v1"
"knative.dev/serving/pkg/apis/serving/v1beta1"
metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
"k8s.io/apimachinery/pkg/types"
"k8s.io/apimachinery/pkg/util/wait"
pkgTest "knative.dev/pkg/test"
rtesting "knative.dev/serving/pkg/testing/v1beta1"
"knative.dev/serving/test"
)
// CreateConfiguration create a configuration resource in namespace with the name names.Config
// that uses the image specified by names.Image.
func CreateConfiguration(t pkgTest.T, clients *test.Clients, names test.ResourceNames, fopt ...rtesting.ConfigOption) (*v1beta1.Configuration, error) {
config := Configuration(names, fopt...)
LogResourceObject(t, ResourceObjects{Config: config})
return clients.ServingBetaClient.Configs.Create(config)
}
// PatchConfig patches the existing configuration passed in with the applied mutations.
// Returns the latest configuration object
func PatchConfig(t pkgTest.T, clients *test.Clients, svc *v1beta1.Configuration, fopt ...rtesting.ConfigOption) (*v1beta1.Configuration, error) {
newSvc := svc.DeepCopy()
for _, opt := range fopt {
opt(newSvc)
}
LogResourceObject(t, ResourceObjects{Config: newSvc})
patchBytes, err := duck.CreateBytePatch(svc, newSvc)
if err != nil {
return nil, err
}
return clients.ServingBetaClient.Configs.Patch(svc.ObjectMeta.Name, types.JSONPatchType, patchBytes, "")
}
// WaitForConfigLatestPinnedRevision enables the check for pinned revision in WaitForConfigLatestRevision.
func WaitForConfigLatestPinnedRevision(clients *test.Clients, names test.ResourceNames) (string, error) {
return WaitForConfigLatestRevision(clients, names, true /*wait for pinned revision*/)
}
// WaitForConfigLatestUnpinnedRevision disables the check for pinned revision in WaitForConfigLatestRevision.
func WaitForConfigLatestUnpinnedRevision(clients *test.Clients, names test.ResourceNames) (string, error) {
return WaitForConfigLatestRevision(clients, names, false /*wait for unpinned revision*/)
}
// WaitForConfigLatestRevision takes a revision in through names and compares it to the current state of LatestCreatedRevisionName in Configuration.
// Once an update is detected in the LatestCreatedRevisionName, the function waits for the created revision to be set in LatestReadyRevisionName
// before returning the name of the revision.
// Make sure to enable ensurePinned flag if the revision has an associated Route.
func WaitForConfigLatestRevision(clients *test.Clients, names test.ResourceNames, ensurePinned bool) (string, error) {
var revisionName string
err := WaitForConfigurationState(clients.ServingBetaClient, names.Config, func(c *v1beta1.Configuration) (bool, error) {
if c.Status.LatestCreatedRevisionName != names.Revision {
revisionName = c.Status.LatestCreatedRevisionName
if ensurePinned {
// Without this it might happen that the latest created revision is later overridden by a newer one
// that is pinned and the following check for LatestReadyRevisionName would fail.
return CheckRevisionState(clients.ServingBetaClient, revisionName, IsRevisionPinned) == nil, nil
}
return true, nil
}
return false, nil
}, "ConfigurationUpdatedWithRevision")
if err != nil {
return "", fmt.Errorf("LatestCreatedRevisionName not updated: %w", err)
}
if err = WaitForConfigurationState(clients.ServingBetaClient, names.Config, func(c *v1beta1.Configuration) (bool, error) {
return (c.Status.LatestReadyRevisionName == revisionName), nil
}, "ConfigurationReadyWithRevision"); err != nil {
return "", fmt.Errorf("LatestReadyRevisionName not updated with %s: %w", revisionName, err)
}
return revisionName, nil
}
// ConfigurationSpec returns the spec of a configuration to be used throughout different
// CRD helpers.
func ConfigurationSpec(imagePath string) *v1.ConfigurationSpec {
return &v1.ConfigurationSpec{
Template: v1.RevisionTemplateSpec{
Spec: v1.RevisionSpec{
PodSpec: corev1.PodSpec{
Containers: []corev1.Container{{
Image: imagePath,
}},
},
},
},
}
}
// Configuration returns a Configuration object in namespace with the name names.Config
// that uses the image specified by names.Image
func Configuration(names test.ResourceNames, fopt ...rtesting.ConfigOption) *v1beta1.Configuration {
config := &v1beta1.Configuration{
ObjectMeta: metav1.ObjectMeta{
Name: names.Config,
},
Spec: *ConfigurationSpec(pkgTest.ImagePath(names.Image)),
}
for _, opt := range fopt {
opt(config)
}
return config
}
// WaitForConfigurationState polls the status of the Configuration called name
// from client every PollInterval until inState returns `true` indicating it
// is done, returns an error or PollTimeout. desc will be used to name the metric
// that is emitted to track how long it took for name to get into the state checked by inState.
func WaitForConfigurationState(client *test.ServingBetaClients, name string, inState func(c *v1beta1.Configuration) (bool, error), desc string) error {
span := logging.GetEmitableSpan(context.Background(), fmt.Sprintf("WaitForConfigurationState/%s/%s", name, desc))
defer span.End()
var lastState *v1beta1.Configuration
waitErr := wait.PollImmediate(test.PollInterval, test.PollTimeout, func() (bool, error) {
var err error
lastState, err = client.Configs.Get(name, metav1.GetOptions{})
if err != nil {
return true, err
}
return inState(lastState)
})
if waitErr != nil {
return fmt.Errorf("configuration %q is not in desired state, got: %+v: %w", name, lastState, waitErr)
}
return nil
}
// CheckConfigurationState verifies the status of the Configuration called name from client
// is in a particular state by calling `inState` and expecting `true`.
// This is the non-polling variety of WaitForConfigurationState
func CheckConfigurationState(client *test.ServingBetaClients, name string, inState func(r *v1beta1.Configuration) (bool, error)) error {
c, err := client.Configs.Get(name, metav1.GetOptions{})
if err != nil {
return err
}
if done, err := inState(c); err != nil {
return err
} else if !done {
return fmt.Errorf("configuration %q is not in desired state, got: %+v", name, c)
}
return nil
}
// IsConfigurationReady will check the status conditions of the config and return true if the config is
// ready. This means it has at least created one revision and that has become ready.
func IsConfigurationReady(c *v1beta1.Configuration) (bool, error) {
return c.Generation == c.Status.ObservedGeneration && c.Status.IsReady(), nil
}