Enterprise Distributed Application Service:DeployK8sApplication

O script a ser executado antes de parar o contêiner. Exemplo: {"tcpSocket":{"host":"", "port":8080}}. Para excluir esta configuração, defina o parâmetro como {}. Se você não definir este parâmetro, a configuração será ignorada.

As variáveis de ambiente para a implantação. O valor deve ser um array JSON de objetos. Três tipos de variáveis de ambiente são suportados: regulares, ConfigMap do Kubernetes e Secret do Kubernetes. O formato para uma variável de ambiente regular é o seguinte:

{"name":"x", "value": "y"}

Uma variável de ambiente ConfigMap injeta o valor de uma chave especificada de um ConfigMap nas variáveis de ambiente do contêiner. O formato é o seguinte:

{ "name": "x2", "valueFrom": { "configMapKeyRef": { "name": "my-config", "key": "y2" } } }

Uma variável de ambiente Secret injeta o valor de uma chave especificada de um Secret nas variáveis de ambiente do contêiner. O formato é o seguinte:

{ "name": "x3", "valueFrom": { "secretKeyRef": { "name": "my-secret", "key": "y3" } } }

A tag da imagem.

O intervalo mínimo para uma liberação em fases de pods. Para mais informações, consulte minReadySeconds.

O comando de inicialização do contêiner.

O ID da aplicação. Obtenha o ID chamando a operação ListApplication. Para mais informações, consulte ListApplication.

O script a ser executado após a inicialização do contêiner. Exemplo: {"exec":{"command":["cat","/etc/group"]}}. Para excluir esta configuração, defina o parâmetro como {}. Se você não definir este parâmetro, a configuração será ignorada.

A sondagem de prontidão para o contêiner. Se a sondagem falhar, o tráfego do serviço Kubernetes não será roteado para o contêiner. Exemplo: {"failureThreshold": 3,"initialDelaySeconds": 5,"successThreshold": 1,"timeoutSeconds": 1,"httpGet": {"path": "/consumer","port": 8080,"scheme": "HTTP","httpHeaders": [{"name": "test","value": "testvalue"}]}}. Para excluir esta configuração, defina o parâmetro como "" ou {}. Se você não definir este parâmetro, a configuração será ignorada.

A sondagem de atividade para o contêiner. Exemplo: {"failureThreshold": 3,"initialDelaySeconds": 5,"successThreshold": 1,"timeoutSeconds": 1,"tcpSocket":{"host":"", "port":8080}}. Para excluir esta configuração, defina o parâmetro como "" ou {}. Se você não definir este parâmetro, a configuração será ignorada.

Os argumentos para o comando de inicialização do contêiner. O valor deve ser um array JSON de strings, como ["Argument 1", "Argument 2"]. Para limpar os argumentos, defina o parâmetro como um array JSON vazio "[]".

O número de instâncias da aplicação. O valor mínimo é 0.

A URL completa da imagem. Este parâmetro sobrescreve o parâmetro ImageTag.

O limite de CPU para a instância da aplicação durante a execução. Unidade: núcleos. Um valor de 0 significa sem limite.

O limite de memória para a instância da aplicação durante a execução. Unidade: MB. Um valor de 0 significa sem limite.

A cota de CPU a ser solicitada para a instância da aplicação durante a execução. Recomenda-se definir este parâmetro. Unidade: núcleos. Um valor de 0 significa sem limite.

A cota de memória a ser solicitada para a instância da aplicação durante a execução. Recomenda-se definir este parâmetro. Unidade: MB. Um valor de 0 significa sem solicitação.

O ID do sistema de arquivos do Apsara File Storage NAS (NAS) a ser montado. O sistema de arquivos NAS deve estar na mesma região do cluster. Ele deve ter uma cota de destino de montagem disponível, ou seu destino de montagem deve estar em um vSwitch na VPC. Se você não definir este parâmetro, mas o campo mountDescs existir, um sistema de arquivos NAS será comprado e montado automaticamente em um vSwitch na VPC por padrão.

As configurações de montagem, que são uma string JSON serializada. Exemplo: [{"nasPath": "/k8s","mountPath": "/mnt"},{"nasPath": "/files","mountPath": "/app/files"}]. Neste exemplo, nasPath é o caminho de armazenamento de arquivos e mountPath é o caminho no contêiner onde o sistema de arquivos é montado.

O tipo de armazenamento do sistema de arquivos NAS. Valores válidos:

• NAS de uso geral: `Capacity` e `Performance`

• NAS extremo: `standard` e `advance`

Atualmente, apenas o tipo `Performance` é suportado.

A configuração para montar um arquivo do host em um contêiner. Exemplo: [{"type":"","nodePath":"/localfiles","mountPath":"/app/files"},{"type":"Directory","nodePath":"/mnt","mountPath":"/app/storage"}]. Neste exemplo, nodePath é o caminho do host, mountPath é o caminho no contêiner e type é o tipo de montagem.

A URL do pacote de implantação. Configure este parâmetro para aplicações implantadas usando um pacote FatJar ou WAR.

O número da versão do pacote de implantação. Este parâmetro é obrigatório para pacotes WAR e FatJar. Você pode definir o significado do número da versão.

A versão do JDK da qual o pacote de implantação depende. Valores válidos: Open JDK 7, Open JDK 8 ou Custom OpenJDK. Este parâmetro não é suportado para implantações baseadas em imagem. Se você usar Custom OpenJDK, também deverá configurar o campo UserBaseImageUrl.

A versão do Tomcat da qual o pacote de implantação depende. Este parâmetro se aplica a aplicações Spring Cloud e Dubbo implantadas usando pacotes WAR. Não é suportado para implantações baseadas em imagem.

A versão do EDAS Container da qual o pacote de implantação depende. Este parâmetro se aplica a aplicações HSF implantadas usando pacotes WAR. Não é suportado para implantações baseadas em imagem.

O formato de codificação URI. Formatos suportados: ISO-8859-1, GBK, GB2312 e UTF-8.

Especifica se deve ativar useBodyEncodingForURI.

A política de liberação em fases.

• Exemplo 1: Liberação em fases com uma instância canary, seguida por dois lotes, loteamento automático e um intervalo de 1 minuto. {"type":"GrayBatchUpdate","batchUpdate":{"batch":2,"releaseType":"auto","batchWaitTime":1},"grayUpdate":{"gray":1}}

• Exemplo 2: Liberação em fases com uma instância canary, seguida por dois lotes e loteamento manual. {"type":"GrayBatchUpdate","batchUpdate":{"batch":2,"releaseType":"manual"},"grayUpdate":{"gray":1}}

• Exemplo 3: Liberação em fases em dois lotes, com loteamento automático e um intervalo de 0 minuto. {"type":"BatchUpdate","batchUpdate":{"batch":2,"releaseType":"auto","batchWaitTime":0}}

O requisito mínimo de recurso de CPU. Unidade: núcleos. Um valor de 0 significa sem limite.

A CPU máxima que pode ser usada. Unidade: núcleos. Um valor de 0 significa sem limite.

Os volumes de dados.

O ID da versão do pacote de implantação.

A descrição do registro de alteração.

O tipo de tempo de execução do contêiner:

• runc: tempo de execução de contêiner regular.

• runv: contêiner em sandbox.

Este parâmetro se aplica apenas a clusters que usam contêineres em sandbox.

Especifica se as instâncias da aplicação devem ser distribuídas por várias zonas. true indica sim, e outros valores indicam não.

O período de tempo limite para uma liberação de lote único. Unidade: segundos.

Especifica se deve conectar ao Application High Availability Service (AHAS).

A configuração do contêiner Tomcat. Defina como "" ou "{}" para excluir a configuração:

• useDefaultConfig: Especificifica se deve usar uma configuração personalizada. Se true, a configuração personalizada não é usada. Se false, a configuração personalizada é usada. Se você não usar uma configuração personalizada, as seguintes configurações de parâmetro não terão efeito.

• contextInputType: O caminho de acesso da aplicação.

  • war: Você não precisa inserir um caminho personalizado. O caminho de acesso é o nome do pacote WAR.

  • root: Você não precisa inserir um caminho personalizado. O caminho de acesso é /.

  • custom: Você precisa inserir um caminho personalizado no parâmetro contextPath abaixo.

• contextPath: O caminho personalizado. Este parâmetro é obrigatório apenas quando contextInputType é definido como custom.

• httpPort: O número da porta. O intervalo válido é de 1024 a 65535. Portas menores que 1024 requerem permissões de root. Como o contêiner é configurado com permissões de administrador, especifique um número de porta maior que 1024. Se você não configurar isso, a porta padrão será 8080.

• maxThreads: O tamanho do pool de conexões. O valor padrão é 400.

  Nota

  Esta configuração afeta muito o desempenho da aplicação. Configure-a sob orientação profissional.

• uriEncoding: O formato de codificação para o Tomcat. Valores válidos: UTF-8, ISO-8859-1, GBK e GB2312. Se você não definir isso, o padrão é ISO-8859-1.

• useBodyEncoding: Especifica se deve usar BodyEncoding para URLs.

• useAdvancedServerXml: Especifica se deve usar a configuração avançada para personalizar o arquivo server.xml. Se os tipos e valores de parâmetros anteriores não atenderem às suas necessidades, você pode usar as configurações avançadas para editar diretamente o arquivo Server.xml do Tomcat.

• serverXml: O conteúdo do arquivo de texto server.xml personalizado na configuração avançada. Isso entra em vigor quando useAdvancedServerXml é true.

Os parâmetros de inicialização do Java. Você pode configurar memória, aplicação, política de coleta de lixo (GC), ferramentas, registro e descoberta de serviços e configurações personalizadas. Configurar corretamente esses parâmetros ajuda a reduzir a sobrecarga de GC, encurtar o tempo de resposta do servidor e melhorar a taxa de transferência. O parâmetro é uma string JSON. original é o valor de configuração e startup é o parâmetro de inicialização. O sistema concatena automaticamente todos os valores de startup como os parâmetros de inicialização do Java para a aplicação. Defina como "" ou "{}" para excluir a configuração.

A configuração do Logstore. Defina como "" ou "{}" para excluir a configuração:

• Configs:

  • type: O tipo de coleta. file para o tipo de arquivo, stdout para o tipo de saída padrão.

  • Logstore: O nome do Logstore. Certifique-se de que o nome do Logstore seja exclusivo no mesmo cluster. O nome deve seguir estas regras:

    • Pode conter apenas letras minúsculas, números, hifens (-) e sublinhados (_).

    • Deve começar e terminar com uma letra minúscula ou um número.

    • O nome deve ter de 3 a 63 caracteres. Se deixado em branco, o sistema gera um nome automaticamente.

  • LogDir: Se o tipo for saída padrão, o caminho de coleta é stdout.log. Se o tipo for arquivo, este é o caminho do arquivo a ser coletado. Curingas são suportados. O caminho de coleta deve corresponder à expressão regular: ^/(.+)/(.*)^/$.

Especifica se as instâncias da aplicação devem ser distribuídas por vários nós. true indica sim, e outros valores indicam não.

A política de controle de tráfego para liberação em fases.

Configura as montagens de PersistentVolumeClaim (PVC) do Kubernetes. Isso permite montar um volume PVC do Kubernetes em um diretório de contêiner especificado. Os parâmetros para PvcMountDescs são os seguintes:

• pvcName: O nome do volume PVC. O volume PVC já deve existir e estar no estado Bound.

• mountPaths: Uma lista de diretórios de montagem. Você pode configurar vários diretórios de montagem. Cada diretório de montagem suporta os seguintes dois parâmetros:

  • mountPath: O caminho de montagem. Um caminho absoluto no contêiner que começa com uma barra (/).

  • readOnly: O modo de montagem. true para somente leitura, false para leitura e gravação. O padrão é false.

Configura as montagens de ConfigMap e Secret do Kubernetes. Isso permite montar um ConfigMap ou Secret em um diretório de contêiner especificado. Os parâmetros para ConfigMountDescs são os seguintes:

• name: O nome do ConfigMap ou Secret.

• type: O tipo de configuração. ConfigMap e Secret são suportados.

• mountPath: O caminho de montagem. Um caminho absoluto no contêiner que começa com uma barra (/).

Configura variáveis de ambiente do tipo EnvFrom do Kubernetes. Isso monta um ConfigMap ou Secret especificado em um diretório. Cada chave corresponde a um arquivo no diretório, e o conteúdo do arquivo é o valor da chave.

Os parâmetros para EnvFroms são os seguintes.

• configMapRef: Uma referência a um ConfigMap. Este campo inclui o seguinte parâmetro:

  • name: O nome do ConfigMap.

• secretRef: Uma referência a um Secret. Este campo inclui o seguinte parâmetro:

  • name: O nome do Secret.

Configura as montagens emptyDir do Kubernetes. Isso permite montar um volume emptyDir em um diretório de contêiner especificado. Os parâmetros para EmptyDirs são os seguintes:

• mountPath: O caminho de montagem do contêiner. Isso é obrigatório.

• readOnly: Especifica se o volume é somente leitura. Opcional. true para somente leitura, false para leitura e gravação. O padrão é false.

• subPathExpr: A expressão do subdiretório. Opcional.

A configuração de afinidade de pod. Isso entra em vigor apenas quando DeployAcrossNodes e DeployAcrossZones são false.

A configuração de tolerância de agendamento de pod. Isso entra em vigor apenas quando DeployAcrossNodes e DeployAcrossZones são false.

O número do pacote de compilação para o EDAS Container:

• Se você não precisar alterar a versão do EDAS Container durante a implantação, poderá deixar este parâmetro indefinido.

• Para atualizar a versão do EDAS Container da aplicação de destino durante esta implantação, você deve definir este parâmetro.

Você pode obter o número de duas maneiras:

• Chame a operação ListBuildPack para consultar a lista de versões do contêiner. Para mais informações, consulte ListBuildPack.

• Obtenha-o na coluna Número do Pacote de Compilação na tabela Guia de versões. Por exemplo, 59 indica EDAS Container 3.5.8.

As anotações para o pod da aplicação.

Os rótulos para o pod da aplicação.

Especifica se deve ativar a proteção contra push vazio:

• true: Ativar a proteção contra push vazio.

• false: Não ativar a proteção contra push vazio.

Especifica se deve ativar a regra de inicialização graceful:

• true: Ativar a regra de inicialização graceful.

• false: Não ativar a regra de inicialização graceful.

A duração do prefetch do serviço. Unidade: segundos. O valor varia de 0 a 86400.

A latência de registro do serviço. Unidade: segundos. O valor varia de 0 a 86400.

A curva de prefetch do serviço. O valor varia de 0 a 20. O padrão é 2, o que é adequado para cenários gerais de prefetch. Isso indica que a curva de recebimento de tráfego do provedor de serviços segue uma curva quadrática durante o período de prefetch.

Especifica se deve ativar o modo de implantação rolling graceful para concluir o registro do serviço antes que a sondagem de prontidão seja bem-sucedida:

• true: Esta opção fornece uma verificação de integridade para a aplicação na porta 55199 e no caminho /health sem intrusão. Quando o registro do serviço é concluído, a interface retorna 200. Caso contrário, retorna 500.

• false: Não fornece uma interface para a aplicação verificar se o registro do serviço foi concluído.

Especifica se deve ativar o modo de implantação rolling graceful para concluir o prefetch do serviço antes que a sondagem de prontidão seja bem-sucedida:

• true: Esta opção fornece uma verificação de integridade para a aplicação na porta 55199 e no caminho /health sem intrusão. Quando o prefetch do serviço é concluído, a interface retorna 200. Caso contrário, retorna 500.

• false: Não fornece uma interface para a aplicação verificar se o prefetch do serviço foi concluído.

O limite superior do requisito de recurso de armazenamento temporário. Unidade: GB. Um valor de 0 significa sem limite.

O requisito mínimo de recurso de armazenamento temporário. Unidade: GB. Um valor de 0 significa sem limite.

Define um contêiner sidecar para o pod da aplicação. A configuração do contêiner está no formato YAML. O valor é a configuração YAML do contêiner sidecar codificada em base64.

Define um contêiner de inicialização para o pod da aplicação. A configuração do contêiner está no formato YAML. O valor é a configuração YAML do contêiner de inicialização codificada em base64.

Ao usar um tempo de execução JDK personalizado, você deve configurar o endereço da imagem base. Este endereço deve ser acessível publicamente. O servidor EDAS extrai esta imagem para compilar a imagem da aplicação.

O ID da política de regra de liberação canary.

O período de tempo limite para parada graceful da aplicação. Unidade: segundos.

A arquitetura da plataforma de destino para a imagem. Isso é válido ao implantar com um arquivo WAR ou JAR. Exemplos:

• Para especificar a arquitetura x86-64: `linux/amd64`

• Para especificar a arquitetura ARM 64: `linux/arm64`

• Para compilar uma imagem de arquitetura dupla: `linux/amd64,linux/arm64`

• Se você não inserir um valor, a arquitetura padrão será usada.

A sondagem de inicialização pode ser usada para realizar verificações de atividade em contêineres de inicialização lenta para evitar que sejam encerrados antes de estarem prontos e em execução. Exemplo: {"failureThreshold": 3,"initialDelaySeconds": 5,"successThreshold": 1,"timeoutSeconds": 1,"httpGet": {"path": "/consumer","port": 8080,"scheme": "HTTP","httpHeaders": [{"name": "test","value": "testvalue"}]}}.

Para excluir esta configuração, defina o parâmetro como "" ou {}. Se você não definir este parâmetro, a configuração será ignorada.

Define a versão do agente personalizado do Application Real-Time Monitoring Service (ARMS) a ser montado na aplicação.

Define a propriedade SecurityContext para o contêiner do pod da aplicação. O valor é a configuração YAML do SecurityContext codificada em base64.