awscdk-kubectl-go: Does not compile with latest cdk - "duplicate method Env"

[chlunde]

Describe the bug

Hi, it seems kubectl-go needs to be updated to support the latest CDK, could you check?

Related: #36060

==> go.mod <==
module poc

go 1.26.1

require (
        github.com/aws/aws-cdk-go/awscdk/v2 v2.245.0
        github.com/aws/constructs-go/constructs/v10 v10.5.1
        github.com/aws/jsii-runtime-go v1.127.0
        github.com/cdklabs/awscdk-kubectl-go/kubectlv35/v2 v2.2.0
)

==> main.go <==
package main

import (
        "github.com/aws/aws-cdk-go/awscdk/v2"
        "github.com/aws/constructs-go/constructs/v10"
        "github.com/aws/jsii-runtime-go"
        kubectlv35 "github.com/cdklabs/awscdk-kubectl-go/kubectlv35/v2"
)

func main() {
        app := awscdk.NewApp(nil)
        stack := awscdk.NewStack(app, jsii.String("poc"), nil)
        _ = kubectlv35.NewKubectlV35Layer(stack, jsii.String("kubectl"))
        _ = constructs.NewConstruct(stack, jsii.String("c"))
        app.Synth(nil)
}

Regression Issue

• Select this option if this issue appears to be a regression.

Last Known Working CDK Library Version

v2.223.0

Expected Behavior

Builds fine

Current Behavior

Doesn't build

/tmp/kubectlv35-poc$ go mod tidy && go build .
# github.com/cdklabs/awscdk-kubectl-go/kubectlv35/v2
/home/.../go/pkg/mod/github.com/cdklabs/awscdk-kubectl-go/kubectlv35/v2@v2.2.0/KubectlV35Layer.go:16:2: duplicate method Env
        /home/.../go/pkg/mod/github.com/cdklabs/awscdk-kubectl-go/kubectlv35/v2@v2.2.0/KubectlV35Layer.go:29:2: other declaration of method Env
/home/.../go/pkg/mod/github.com/cdklabs/awscdk-kubectl-go/kubectlv35/v2@v2.2.0/KubectlV35Layer.go:29:16: undefined: awscdk.ResourceEnvironment
/home/.../go/pkg/mod/github.com/cdklabs/awscdk-kubectl-go/kubectlv35/v2@v2.2.0/KubectlV35Layer.go:106:51: undefined: awscdk.ResourceEnvironment
/home/.../go/pkg/mod/github.com/cdklabs/awscdk-kubectl-go/kubectlv35/v2@v2.2.0/KubectlV35Layer.go:107:22: undefined: awscdk.ResourceEnvironment

Reproduction Steps

Se POC above.

Possible Solution

I haven't checked the code in question, but type aliases and/or getting KubectlV3xLayer.go to use interfaces.ResourceEnvironment instead of awscdk.ResourceEnvironment, and renaming/removing the duplicate Env() might be relevant.

Additional Information/Context

No response

AWS CDK Library version (aws-cdk-lib)

v2.245.0

AWS CDK CLI version

N/A

Node.js Version

N/A

OS

Linux

Language

Go

Language Version

1.26.1

Other information

No response

[pahud]

Hi @chlunde,

┌──────────────────────────────────────────────────────┐
│ 🔴 Reported State                                    │
│ kubectlv35 v2.2.0 won't compile with awscdk ≥2.224.0│
│ "duplicate method Env" / "undefined ResourceEnv"     │
└──────────────────────────┬───────────────────────────┘
                           │
                           ▼
┌──────────────────────────────────────────────────────┐
│ 🔍 Root Cause                                        │
│ kubectlv35 generated code still references the old   │
│ awscdk.ResourceEnvironment (moved to interfaces pkg) │
│ KubectlV35Layer.go L29 + internal/types.go           │
└──────────────────────────┬───────────────────────────┘
                           │
                           ▼
┌──────────────────────────────────────────────────────┐
│ 🟢 Suggested Fix                                     │
│ Regenerate awscdk-kubectl-go bindings against         │
│ awscdk/v2 ≥ v2.224.0 with updated jsii codegen      │
└──────────────────────────────────────────────────────┘

Thanks for reporting this — good catch linking it to #36060.

I wasn't able to reproduce this locally (Go proxy unreachable), but from the source code the issue is clear. The KubectlV35Layer interface explicitly declares Env() *awscdk.ResourceEnvironment, but since #35971 (shipped in v2.224.0), ResourceEnvironment was moved to the interfaces submodule. The parent LayerVersion interface now inherits Env() from interfaces.IEnvironmentAware, so the stale explicit declaration creates both a "duplicate method" and an "undefined type" error.

The fix needs to happen in cdklabs/awscdk-kubectl-go — the bindings need to be regenerated against awscdk/v2 >= v2.224.0 so the generated code uses interfaces.ResourceEnvironment instead of awscdk.ResourceEnvironment, and drops the now-redundant Env() declaration. This affects all kubectl version branches.

As a temporary workaround, pinning awscdk/v2 to v2.223.0 in your go.mod should unblock you, though it obviously limits you to older CDK features.

In my opinion, this is a p1 since it blocks all Go users of awscdk-kubectl-go from upgrading past v2.223.0. Will notify the team immediately.

[pahud]

This affects golang users as a regression. Bumping to p0.