Container Service for Kubernetes:ack-pod-identity-webhook overview and release notes

Parâmetro

Tipo

Descrição

AutoInjectSTSEnvVars

boolean

Compatível com a versão 0.4.0 e posteriores.

Defina se as variáveis de ambiente relacionadas ao Security Token Service (STS) são injetadas nos pods por padrão.

• true: ative esse recurso.

• false: desativa esse recurso.

Parâmetro

Tipo

Descrição

Código de exemplo

pod-identity.alibabacloud.com/injection

label

Defina se a injeção automática de configurações é ativada para os pods neste namespace.

• on: ative a injeção automática de configurações no nível do namespace.

• Ausente ou qualquer outro valor: desativa a injeção automática de configurações no nível do namespace.

apiVersion: v1
kind: Namespace
metadata:
  name: test
  labels:
    pod-identity.alibabacloud.com/injection: 'on'

pod-identity.alibabacloud.com/override-env

label

Compatível com a versão 0.4.2 e posteriores.

Defina se a substituição automática de configurações é ativada para os pods neste namespace. Se uma variável de ambiente definida no pod tiver o mesmo nome de uma variável injetada pelo add-on, o valor injetado prevalecerá.

• true: ative a substituição automática de configurações no nível do namespace.

• Ausente ou qualquer outro valor: desativa a substituição automática de configurações no nível do namespace.

apiVersion: v1
kind: Namespace
metadata:
  name: test
  labels:
    pod-identity.alibabacloud.com/override-env: 'true'

Parâmetro

Tipo

Descrição

Código de exemplo

pod-identity.alibabacloud.com/role-name

Annotation

Nome da função do RAM associada a este ServiceAccount. Se esta Annotation estiver ausente ou seu valor não for um nome válido de função do RAM, as configurações não serão injetadas nos pods que utilizam este ServiceAccount.

apiVersion: v1
kind: ServiceAccount
metadata:
  name: test-sa
  namespace: test
  annotations:
    pod-identity.alibabacloud.com/role-name: test-role

pod-identity.alibabacloud.com/service-account-token-expiration

Annotation

Período de validade do token OIDC montado pelos pods que utilizam este ServiceAccount.

Valores válidos: 600 a 43200. Unidade: segundos.

Valor padrão: 3600. Valores inválidos revertem para o padrão.

apiVersion: v1
kind: ServiceAccount
metadata:
  name: test-sa
  namespace: test
  annotations:
    pod-identity.alibabacloud.com/service-account-token-expiration: '3600'

pod-identity.alibabacloud.com/inject-sts-endpoint

Annotation

Compatível com a versão 0.3.0 e posteriores.

Defina se a variável de ambiente ALIBABA_CLOUD_STS_ENDPOINT é injetada nos pods que utilizam este ServiceAccount.

• on: injeta essa variável de ambiente.

• Ausente ou qualquer outro valor: não injeta essa variável de ambiente.

apiVersion: v1
kind: ServiceAccount
metadata:
  name: test-sa
  namespace: test
  annotations:
    pod-identity.alibabacloud.com/inject-sts-endpoint: 'on'

Parâmetro

Tipo

Descrição

Código de exemplo

pod-identity.alibabacloud.com/injection

label

Compatível com a versão 0.2.0 e posteriores.

Defina se a injeção automática de configurações é ativada para este pod.

• on: ative a injeção automática de configurações.

• Ausente ou qualquer outro valor: a configuração do namespace determina se a injeção automática está ativada.

apiVersion: v1
kind: Pod
metadata:
  name: test
  labels:
    pod-identity.alibabacloud.com/injection: 'on'

pod-identity.alibabacloud.com/override-env

Annotation

Compatível com a versão 0.4.2 e posteriores.

Defina se a substituição automática de configurações é ativada para este pod. Se uma variável de ambiente definida no pod tiver o mesmo nome de uma variável injetada pelo add-on, o valor injetado prevalecerá.

• true: ative a substituição automática de configurações.

• Ausente ou qualquer outro valor: a configuração do namespace determina se a substituição automática está ativada.

apiVersion: v1
kind: Pod
metadata:
  name: test
  annotations:
    pod-identity.alibabacloud.com/override-env: 'true'

pod-identity.alibabacloud.com/service-account-token-expiration

Annotation

Período de validade do token OIDC montado por este pod.

Valores válidos: 600 a 43200. Unidade: segundos.

Valor padrão: 3600. Valores inválidos revertem para o padrão.

apiVersion: v1
kind: Pod
metadata:
  name: test-pod
  namespace: test
  annotations:
    pod-identity.alibabacloud.com/service-account-token-expiration: '3600'

pod-identity.alibabacloud.com/only-containers

Annotation

Restringe a injeção automática de configurações aos contêineres com os nomes especificados no pod. Separe vários nomes de contêineres com vírgulas (,).

Se este item de configuração estiver ausente, as configurações serão injetadas em todos os contêineres do pod.

apiVersion: v1
kind: Pod
metadata:
  name: test-pod
  namespace: test
  annotations:
    pod-identity.alibabacloud.com/only-containers: 'controller,test'

pod-identity.alibabacloud.com/skip-containers

Annotation

Exclui os contêineres com os nomes especificados no pod da injeção automática de configurações. Separe vários nomes de contêineres com vírgulas (,).

apiVersion: v1
kind: Pod
metadata:
  name: test-pod
  namespace: test
  annotations:
    pod-identity.alibabacloud.com/skip-containers: 'controller,test'

Versão

Endereço da imagem

Data de lançamento

Alterações

Impacto

0.3.1

registry-cn-hangzhou.ack.aliyuncs.com/acs/ack-pod-identity-webhook:0.3.1

8 de setembro de 2025

Atualização da versão do Go para 1.24.6 para melhorar a estabilidade.

A criação de pods pode falhar se ocorrer uma exceção durante a atualização. Atualize a imagem do add-on fora dos horários de pico.

Versão

Endereço da imagem

Data de lançamento

Alterações

Impacto

0.3.0

registry-cn-hangzhou.ack.aliyuncs.com/acs/ack-pod-identity-webhook:v0.3.0.0-g433f84b-aliyun

6 de junho de 2025

Suporte adicionado para configurar pod-identity.alibabacloud.com/inject-sts-endpoint em um ServiceAccount e injetar a variável de ambiente ALIBABA_CLOUD_STS_ENDPOINT nos pods.

A criação de pods pode falhar se ocorrer uma exceção durante a atualização. Atualize a imagem do add-on fora dos horários de pico.

Versão

Endereço da imagem

Data de lançamento

Alterações

Impacto

0.2.1

registry-cn-hangzhou.ack.aliyuncs.com/acs/ack-pod-identity-webhook:v0.2.1.0-g52e519c-aliyun

18 de março de 2025

Atualização da versão do Go para 1.23.7 para melhorar a estabilidade.

A criação de pods pode falhar se ocorrer uma exceção durante a atualização. Atualize a imagem do add-on fora dos horários de pico.

Versão

Endereço da imagem

Data de lançamento

Alterações

Impacto

0.2.0

registry-cn-hangzhou.ack.aliyuncs.com/acs/ack-pod-identity-webhook:v0.2.0.11-g2f0c2e7-aliyun

19 de dezembro de 2024

• Suporte adicionado para ativar a injeção de configurações mediante a adição do label de pod pod-identity.alibabacloud.com/injection: 'on'.

• Melhoria no suporte ao Kubernetes 1.32.

A criação de pods pode falhar se ocorrer uma exceção durante a atualização. Atualize a imagem do add-on fora dos horários de pico.

Versão

Endereço da imagem

Data de lançamento

Alterações

Impacto

0.1.1

registry.cn-hangzhou.aliyuncs.com/acs/ack-pod-identity-webhook:v0.1.1.0-gbddcb74-aliyun

7 de junho de 2023

Melhoria na compatibilidade com cluster ACK Serverless.

A criação de pods pode falhar se ocorrer uma exceção durante a atualização. Atualize a imagem do add-on fora dos horários de pico.

Versão

Endereço da imagem

Data de lançamento

Alterações

Impacto

0.1.0

registry.cn-hangzhou.aliyuncs.com/acs/ack-pod-identity-webhook:v0.1.0.9-g26b8fde-aliyun

1º de fevereiro de 2023

Implementação da montagem automática de tokens OIDC e configuração de variáveis de ambiente para pods de aplicação.

Lançamento inicial.