Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

test/e2e_node: add kubelet credential provider tests #108651

Merged
merged 7 commits into from
Mar 23, 2022
1 change: 1 addition & 0 deletions test/e2e_node/builder/build.go
Original file line number Diff line number Diff line change
Expand Up @@ -35,6 +35,7 @@ var buildTargets = []string{
"test/e2e_node/e2e_node.test",
"vendor/github.com/onsi/ginkgo/ginkgo",
"cluster/gce/gci/mounter",
"test/e2e_node/plugins/gcp-credential-provider",
}

// BuildGo builds k8s binaries.
Expand Down
63 changes: 63 additions & 0 deletions test/e2e_node/image_credential_provider.go
Original file line number Diff line number Diff line change
@@ -0,0 +1,63 @@
/*
Copyright 2022 The Kubernetes 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 e2enode

import (
"github.com/onsi/ginkgo"

v1 "k8s.io/api/core/v1"
metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
"k8s.io/apimachinery/pkg/util/uuid"
"k8s.io/kubernetes/test/e2e/framework"
imageutils "k8s.io/kubernetes/test/utils/image"
)

var _ = SIGDescribe("ImageCredentialProvider [Feature:KubeletCredentialProviders]", func() {
f := framework.NewDefaultFramework("image-credential-provider")
var podClient *framework.PodClient

ginkgo.BeforeEach(func() {
podClient = f.PodClient()
})

/*
Release: v1.24
andrewsykim marked this conversation as resolved.
Show resolved Hide resolved
Testname: Test kubelet image pull with external credential provider plugins
Description: Create Pod with an image from a private registry. This test assumes that the kubelet credential provider plugin is enabled for the registry hosting imageutils.AgnhostPrivate.
*/
ginkgo.It("should be able to create pod with image credentials fetched from external credential provider ", func() {
privateimage := imageutils.GetConfig(imageutils.AgnhostPrivate)
name := "pod-auth-image-" + string(uuid.NewUUID())
pod := &v1.Pod{
ObjectMeta: metav1.ObjectMeta{
Name: name,
},
Spec: v1.PodSpec{
Containers: []v1.Container{
{
Name: "container-auth-image",
Image: privateimage.GetE2EImage(),
ImagePullPolicy: v1.PullAlways,
},
},
},
}

// CreateSync tests that the Pod is running and ready
podClient.CreateSync(pod)
})
})
35 changes: 35 additions & 0 deletions test/e2e_node/plugins/gcp-credential-provider/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
# GCP credential provider for e2e testing

This package contains a barebones implementation of the [kubelet GCP credential
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

barebones implementation

how much different is it from the real one? What is blocking from using a real one? My worry as with any fake that we may end up chasing issues that would result from the infra and the real provider updates.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

how much different is it from the real one?

There are quite a few differences, the actual implementation is here: https://github.com/kubernetes/cloud-provider-gcp/tree/master/cmd/auth-provider-gcp

What is blocking from using a real one?

Having a local copy just for testing is really to avoid dependencies we would have with k8s.io/cloud-provider-gcp. We're trying to remove go module dependencies to cloud provider implementations eventually so it would be counter intuitive to import k8s.io/cloud-provider-gcp in order to test the credential provider mechanism. Luckily the GCP provider doesn't require vendoring a cloud SDK so a local copy just for node e2e testing is actually do-able.

My worry as with any fake that we may end up chasing issues that would result from the infra and the real provider updates.

This is fair and I think the full e2e test suite (not node e2e) should use the actual provider configured via prow jobs. This is something @adisky was working on. The goal of this specific PR is to provide test coverage for the kubelet plugin mechanism itself, it just so happens that we run node e2es on GCE nodes and all the authenticated images are on gcr.io which necessitates this.

I think we're trying to find a balance here of doing the bare minimum to only validate the core Kubernetes parts, i.e. the kubelet code executing the plugins and not the plugins themselves, which is difficult because we heavily rely on GCP infrastructure for our tests.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ok, it is reasonable then. If there is an opportunity to shrink code even further, it will be good.

provider](https://github.com/kubernetes/cloud-provider-gcp/tree/master/cmd/auth-provider-gcp)
for testing purposes only. This plugin SHOULD NOT be used in production.

This credential provider is installed and configured in the node e2e tests by:

1. Building the gcp-credential-provider binary and including it in the test archive
uploaded to the GCE remote node.

2. Writing the credential provider config into the temporary workspace consumed
by the kubelet. The contents of the config should be something like this:

```yaml
kind: CredentialProviderConfig
apiVersion: kubelet.config.k8s.io/v1alpha1
providers:
- name: gcp-credential-provider
apiVersion: credentialprovider.kubelet.k8s.io/v1alpha1
matchImages:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

with this kubernetes/k8s.io#3411 we may need to include registry.k8s.io. Not sure if private registry will also be moved there.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ack -- I don't think any of the authenticated images use that but we should switch over when we do

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

since it's for tests only, should it be just *?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hmm that would mean we run the auth flow for all images, not just the ones the plugin can handle right?

Btw, the match images are taken from here

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't know of any places where we don't use gcr.io for private images yet, but in the future it would be unexpected to run this plugin when the image is from another source

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I was mostly thinking from the perspective of not overcomplicating code as test knows which images will be pulled.

Practically registry.k8s.io will be just a proxy to gcr.io when running in GCE. Speculating here... it is interesting, if this proxy will return 302 with the gcr.io address, will credential provider be used to pull from that redirected source?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hmm that's a good point -- if registry.k8s.io is just an alias for gcr.io domain we might need to adjust the plugin config to handle it

- "gcr.io"
- "*.gcr.io"
- "container.cloud.google.com"
- "*.pkg.dev"
defaultCacheDuration: 1m`
```

3. Configuring the following additional flags on the kubelet:

```
--feature-gates=DisableKubeletCloudCredentialProviders=true,KubeletCredentialProviders=true
--image-credential-provider-config=/tmp/node-e2e-123456/credential-provider.yaml
--image-credential-provider-bin-dir=/tmp/node-e2e-12345
```
80 changes: 80 additions & 0 deletions test/e2e_node/plugins/gcp-credential-provider/main.go
Original file line number Diff line number Diff line change
@@ -0,0 +1,80 @@
/*
Copyright 2022 The Kubernetes 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 main

import (
"encoding/json"
"errors"
"io"
"io/ioutil"
"net/http"
"os"
"time"

metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
"k8s.io/klog/v2"
credentialproviderv1alpha1 "k8s.io/kubelet/pkg/apis/credentialprovider/v1alpha1"
)

const metadataTokenEndpoint = "http://metadata.google.internal./computeMetadata/v1/instance/service-accounts/default/token"

func main() {
if err := getCredentials(metadataTokenEndpoint, os.Stdin, os.Stdout); err != nil {
klog.Fatalf("failed to get credentials: %v", err)
}
}

func getCredentials(tokenEndpoint string, r io.Reader, w io.Writer) error {
provider := &provider{
client: &http.Client{
Timeout: 10 * time.Second,
},
tokenEndpoint: tokenEndpoint,
}

data, err := ioutil.ReadAll(r)
if err != nil {
return err
}

var authRequest credentialproviderv1alpha1.CredentialProviderRequest
err = json.Unmarshal(data, &authRequest)
if err != nil {
return err
}

auth, err := provider.Provide(authRequest.Image)
if err != nil {
return err
}

response := &credentialproviderv1alpha1.CredentialProviderResponse{
TypeMeta: metav1.TypeMeta{
Kind: "CredentialProviderResponse",
APIVersion: "credentialprovider.kubelet.k8s.io/v1alpha1",
},
CacheKeyType: credentialproviderv1alpha1.RegistryPluginCacheKeyType,
Auth: auth,
}

if err := json.NewEncoder(w).Encode(response); err != nil {
// The error from json.Marshal is intentionally not included so as to not leak credentials into the logs
return errors.New("error marshaling response")
}

return nil
}
55 changes: 55 additions & 0 deletions test/e2e_node/plugins/gcp-credential-provider/main_test.go
Original file line number Diff line number Diff line change
@@ -0,0 +1,55 @@
/*
Copyright 2022 The Kubernetes 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 main

import (
"bytes"
"fmt"
"net/http"
"net/http/httptest"
"testing"
)

type fakeTokenServer struct {
token string
}

func (f *fakeTokenServer) ServeHTTP(w http.ResponseWriter, req *http.Request) {
fmt.Fprintf(w, `{"access_token": "%s"}`, f.token)
}

func Test_getCredentials(t *testing.T) {
server := httptest.NewServer(&fakeTokenServer{token: "abc123"})
defer server.Close()

in := bytes.NewBuffer([]byte(`{"kind":"CredentialProviderRequest","apiVersion":"credentialprovider.kubelet.k8s.io/v1alpha1","image":"gcr.io/foobar"}`))
out := bytes.NewBuffer(nil)

err := getCredentials(server.URL, in, out)
if err != nil {
t.Fatalf("unexpected error running getCredentials: %v", err)
}

expected := `{"kind":"CredentialProviderResponse","apiVersion":"credentialprovider.kubelet.k8s.io/v1alpha1","cacheKeyType":"Registry","auth":{"*.gcr.io":{"username":"_token","password":"abc123"},"*.pkg.dev":{"username":"_token","password":"abc123"},"container.cloud.google.com":{"username":"_token","password":"abc123"},"gcr.io":{"username":"_token","password":"abc123"}}}
`

if out.String() != expected {
t.Logf("actual response: %v", out)
t.Logf("expected response: %v", expected)
t.Errorf("unexpected credential provider response")
}
}
121 changes: 121 additions & 0 deletions test/e2e_node/plugins/gcp-credential-provider/provider.go
Original file line number Diff line number Diff line change
@@ -0,0 +1,121 @@
/*
Copyright 2022 The Kubernetes 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.
*/

// Originally copied from pkg/credentialproviders/gcp
package main

import (
"encoding/json"
"errors"
"fmt"
"io"
"io/ioutil"
"net/http"

credentialproviderv1alpha1 "k8s.io/kubelet/pkg/apis/credentialprovider/v1alpha1"
)

const (
maxReadLength = 10 * 1 << 20 // 10MB
)

var containerRegistryUrls = []string{"container.cloud.google.com", "gcr.io", "*.gcr.io", "*.pkg.dev"}

// HTTPError wraps a non-StatusOK error code as an error.
type HTTPError struct {
StatusCode int
URL string
}

var _ error = &HTTPError{}

// Error implements error
func (h *HTTPError) Error() string {
return fmt.Sprintf("http status code: %d while fetching url %s",
h.StatusCode, h.URL)
}

// TokenBlob is used to decode the JSON blob containing an access token
// that is returned by GCE metadata.
type TokenBlob struct {
AccessToken string `json:"access_token"`
}

type provider struct {
client *http.Client
tokenEndpoint string
}

func (p *provider) Provide(image string) (map[string]credentialproviderv1alpha1.AuthConfig, error) {
cfg := map[string]credentialproviderv1alpha1.AuthConfig{}

tokenJSONBlob, err := readURL(p.tokenEndpoint, p.client)
if err != nil {
return cfg, err
}

var parsedBlob TokenBlob
if err := json.Unmarshal(tokenJSONBlob, &parsedBlob); err != nil {
return cfg, err
}

authConfig := credentialproviderv1alpha1.AuthConfig{
Username: "_token",
Password: parsedBlob.AccessToken,
}

// Add our entry for each of the supported container registry URLs
for _, k := range containerRegistryUrls {
cfg[k] = authConfig
}
return cfg, nil
}

func readURL(url string, client *http.Client) (body []byte, err error) {
req, err := http.NewRequest("GET", url, nil)
if err != nil {
return nil, err
}

req.Header = http.Header{
"Metadata-Flavor": []string{"Google"},
}

resp, err := client.Do(req)
if err != nil {
return nil, err
}
defer resp.Body.Close()

if resp.StatusCode != http.StatusOK {
return nil, &HTTPError{
StatusCode: resp.StatusCode,
URL: url,
}
}

limitedReader := &io.LimitedReader{R: resp.Body, N: maxReadLength}
contents, err := ioutil.ReadAll(limitedReader)
if err != nil {
return nil, err
}

if limitedReader.N <= 0 {
return nil, errors.New("the read limit is reached")
}

return contents, nil
}