Serverless App Engine:DeployApplication

O ID do aplicativo a ser implantado.

A versão do JDK da qual o pacote de implantação depende. Valores válidos:

• Open JDK 8

• Open JDK 7

• Dragonwell 11

• Dragonwell 8

• openjdk-8u191-jdk-alpine3.9

• openjdk-7u201-jdk-alpine3.9

Este parâmetro não é suportado quando Package Type está definido como Image.

A versão do Tomcat da qual o pacote de implantação depende. Valores válidos:

• apache-tomcat-7.0.91

• apache-tomcat-8.5.42

Este parâmetro não é suportado quando Package Type está definido como Image.

O número da versão do pacote de implantação. Este parâmetro é obrigatório quando Package Type está definido como FatJar, War ou PythonZip.

A URL do pacote de implantação. Este parâmetro é obrigatório quando Package Type está definido como FatJar, War ou PythonZip.

A URL da imagem. Este parâmetro é obrigatório quando Package Type está definido como Image.

O comando de inicialização da imagem. O comando deve ser um objeto executável no contêiner. Exemplo:

command:
      - echo
      - abc
      - >
      - file0

Com base no exemplo anterior, Command="echo", CommandArgs=["abc", ">", "file0"].

Os argumentos do comando de inicialização da imagem. Estes são os argumentos exigidos pelo comando de inicialização especificado em Command. Formato:

["a","b"]

No exemplo anterior, CommandArgs=["abc", ">", "file0"], onde ["abc", ">", "file0"] deve ser convertido para o tipo String, e o formato interno é um array JSON. Se este parâmetro não for necessário, deixe-o vazio.

Os parâmetros de variáveis de ambiente do contêiner. Você pode personalizar variáveis de ambiente ou referenciar itens do ConfigMap. Para referenciar um item do ConfigMap, crie primeiro uma instância do ConfigMap. Para mais informações, consulte CreateConfigMap. Valores válidos:

• Configuração personalizada

  • name: o nome da variável de ambiente.

  • value: o valor da variável de ambiente. Isso tem prioridade sobre valueFrom.

• Referenciar um item do ConfigMap (valueFrom)

  • name: o nome da variável de ambiente. Para referenciar todas as chaves, insira sae-sys-configmap-all-<ConfigMap name>, como sae-sys-configmap-all-test1.

  • valueFrom: a referência da variável de ambiente. Defina o valor como configMapRef.

  • configMapId: o ID do ConfigMap.

  • key: a chave. Não defina este campo se você quiser referenciar todas as chaves.

• Referenciar um segredo (valueFrom)

  • name: o nome da variável de ambiente. Para referenciar todas as chaves, insira sae-sys-secret-all-<secret name>, como sae-sys-secret-all-test1.

  • valueFrom: a referência da variável de ambiente. Defina o valor como secretRef.

  • secretId: o ID do segredo.

  • key: a chave. Não defina este campo se você quiser referenciar todas as chaves.

O mapeamento de host personalizado no contêiner. Valores válidos:

• hostName: o nome de domínio ou hostname.

• ip: o endereço IP.

As opções de inicialização para um aplicativo baseado em pacote JAR. O comando de inicialização padrão é $JAVA_HOME/bin/java $JarStartOptions -jar $CATALINA_OPTS "$package_path" $JarStartArgs.

Os argumentos de inicialização para um aplicativo baseado em pacote JAR. O comando de inicialização padrão é $JAVA_HOME/bin/java $JarStartOptions -jar $CATALINA_OPTS "$package_path" $JarStartArgs.

A verificação de integridade do contêiner. Contêineres que falham na verificação de integridade são encerrados e recuperados. Os seguintes métodos são suportados:

• exec: por exemplo, {"exec":{"command":\["sh","-c","cat/home/admin/start.sh"]},"initialDelaySeconds":30,"periodSeconds":30,"timeoutSeconds":2}

• httpGet: por exemplo, {"httpGet":{"path":"/","port":18091,"scheme":"HTTP","isContainKeyWord":true,"keyWord":"SAE"},"initialDelaySeconds":11,"periodSeconds":10,"timeoutSeconds":1}

• tcpSocket: por exemplo, {"tcpSocket":{"port":18091},"initialDelaySeconds":11,"periodSeconds":10,"timeoutSeconds":1}

Configurações:

• exec.command: define o comando de verificação de integridade.

• httpGet.path: o caminho de acesso.

• httpGet.scheme: HTTP ou HTTPS.

• httpGet.isContainKeyWord: true indica que a palavra-chave está incluída, false indica que a palavra-chave não está incluída, e a ausência deste campo indica que o recurso avançado não está sendo usado.

• httpGet.keyWord: a palavra-chave personalizada. O campo isContainKeyWord deve estar presente quando este parâmetro for usado.

• tcpSocket.port: a porta para detecção de conexão TCP.

• initialDelaySeconds: define o atraso inicial para a verificação de integridade. Valor padrão: 10. Unidade: segundos.

• periodSeconds: define o intervalo da verificação de integridade. Valor padrão: 30. Unidade: segundos.

• timeoutSeconds: define o período de tempo limite da verificação de integridade. Valor padrão: 1. Unidade: segundos. Se este parâmetro for definido como 0 ou não for definido, o período de tempo limite padrão é de 1 segundo.

A verificação do status de inicialização do aplicativo. Contêineres que falham em múltiplas verificações de integridade são encerrados e reiniciados. Contêineres que não passam na verificação de integridade não recebem tráfego do SLB. Os métodos exec, httpGet e tcpSocket são suportados. Para exemplos específicos, consulte o parâmetro Liveness.

O número mínimo de instâncias disponíveis. Valores válidos:

• Se este parâmetro for definido como 0, o serviço será interrompido durante a atualização.

• Se este parâmetro for definido como -1, o valor recomendado pelo sistema será usado, que corresponde a 25% do número atual de instâncias. Se o número atual de instâncias for 5, 5 × 25% = 1,25, que é arredondado para cima para 2.

A porcentagem mínima de instâncias disponíveis. Valores válidos:

• -1: o valor de inicialização, que indica que a porcentagem não é usada.

• 0~100: a unidade é porcentagem, arredondada para cima. Por exemplo, se este parâmetro for definido como 50% e o número atual de instâncias for 5, o número mínimo de instâncias disponíveis é 3.

O intervalo entre lotes de implantação. Unidade: segundos.

A versão do ambiente de execução do aplicativo no framework HSF, como o contêiner Ali-Tomcat.

A política de implantação. Quando o número mínimo de instâncias disponíveis é 1, o valor do campo UpdateStrategy é "". Quando o número mínimo de instâncias disponíveis é maior que 1, os exemplos são os seguintes:

• 1 instância em escala de cinza + 2 lotes subsequentes + loteamento automático + intervalo de 1 minuto entre lotes: {"type":"GrayBatchUpdate","batchUpdate":{"batch":2,"releaseType":"auto","batchWaitTime":1},"grayUpdate":{"gray":1}}

• 1 instância em escala de cinza + 2 lotes subsequentes + loteamento manual: {"type":"GrayBatchUpdate","batchUpdate":{"batch":2,"releaseType":"manual"},"grayUpdate":{"gray":1}}

• 2 lotes + loteamento automático + intervalo de 0 minutos entre lotes: {"type":"BatchUpdate","batchUpdate":{"batch":2,"releaseType":"auto","batchWaitTime":0}}

Configurações:

• type: o tipo de política de publicação. Valores válidos: GrayBatchUpdate (publicação em escala de cinza) e BatchUpdate (publicação em lotes).

• batchUpdate: a política de publicação em lotes.

  • batch: o número de lotes de publicação.

  • releaseType: o método de processamento entre lotes. Valores válidos: auto (automático) e manual (manual).

  • batchWaitTime: o intervalo entre lotes. Unidade: minutos.

• grayUpdate: o número de instâncias em escala de cinza. Este parâmetro é obrigatório quando type está definido como GrayBatchUpdate.

A configuração para coleta de logs no Simple Log Service.

• Use recursos do SLS criados automaticamente pelo Serverless App Engine: [{"logDir":"","logType":"stdout"},{"logDir":"/tmp/a.log"}].

• Use recursos personalizados do SLS: [{"projectName":"test-sls","logType":"stdout","logDir":"","logstoreName":"sae","logtailName":""},{"projectName":"test","logDir":"/tmp/a.log","logstoreName":"sae","logtailName":""}].

Configurações:

• projectName: o nome do projeto no Simple Log Service.

• logDir: o caminho do log.

• logType: o tipo de log. stdout indica logs de saída padrão do contêiner, e apenas uma entrada pode ser definida. Se este parâmetro não for definido, logs de arquivo serão coletados.

• logstoreName: o nome do Logstore no Simple Log Service.

• logtailName: o nome do Logtail no Simple Log Service. Se este parâmetro não for especificado, um novo Logtail será criado automaticamente.

Se a configuração de coleta do SLS não tiver sido alterada durante várias implantações, você não precisa definir este parâmetro (ou seja, o campo SlsConfigs não precisa ser incluído na solicitação). Se você não precisar mais do recurso de coleta do SLS, defina o valor deste campo como uma string vazia (ou seja, defina o valor do campo SlsConfigs como "" na solicitação).

O fuso horário. Valor padrão: Asia/Shanghai.

Não recomendamos que você configure este campo. Configure NasConfigs em vez disso. O ID do sistema de arquivos NAS. Se a configuração não tiver sido alterada durante a implantação, você não precisa definir este parâmetro (ou seja, o campo NasId não precisa ser incluído na solicitação). Para limpar a configuração do NAS, defina o valor deste campo como uma string vazia (ou seja, defina o valor do campo NasId como "" na solicitação).

Não recomendamos que você configure este campo. Configure NasConfigs em vez disso. O ponto de montagem do sistema de arquivos NAS na VPC do aplicativo. Se a configuração não tiver sido alterada durante a implantação, você não precisa definir este parâmetro (ou seja, o campo MountHost não precisa ser incluído na solicitação). Para limpar a configuração do NAS, defina o valor deste campo como uma string vazia (ou seja, defina o valor do campo MountHost como "" na solicitação).

Não recomendamos que você configure este campo. Configure NasConfigs em vez disso. A descrição da montagem do NAS. Se a configuração não tiver sido alterada durante a implantação, você não precisa definir este parâmetro (ou seja, o campo MountDesc não precisa ser incluído na solicitação). Para limpar a configuração do NAS, defina o valor deste campo como uma string vazia (ou seja, defina o valor do campo MountDesc como "" na solicitação).

O script executado após a inicialização do contêiner. Um script é acionado imediatamente após a criação do contêiner. Formato: {"exec":{"command":\["sh","-c","echo hello"\]}}.

O script executado antes da parada do contêiner. Um script é acionado antes da exclusão do contêiner. Formato: {"exec":{"command":\["sh","-c","echo hello"\]}}.

A descrição da ordem de mudança.

O comando de inicialização para implantar um aplicativo baseado em pacote WAR. O procedimento de configuração é o mesmo do comando de inicialização de uma implantação baseada em imagem. Para mais informações, consulte Configure a startup command.

Especifica se a política de dimensionamento elástico do aplicativo deve ser ativada automaticamente. Valores válidos:

• true: ativado.

• false: desativado.

A descrição da montagem do ConfigMap. Use um ConfigMap criado na página de itens de configuração do namespace para injetar informações de configuração no contêiner. Configurações:

• configMapId: o ID da instância do ConfigMap. Você pode obtê-lo chamando a operação ListNamespacedConfigMaps.

• key: a chave.

• mountPath: o caminho de montagem.

O período de tempo limite para desligamento graceful. Valor padrão: 30. Unidade: segundos. Valores válidos: 1 a 300.

Especifica se o Application High Availability Service (AHAS) deve ser ativado. Valores válidos:

• true: ativa o AHAS.

• false: não ativa o AHAS.

O caminho de montagem para monitoramento de aplicativos PHP. Certifique-se de que o servidor PHP carregue o arquivo de configuração a partir deste caminho. Você não precisa gerenciar o conteúdo da configuração, pois o Serverless App Engine renderiza automaticamente o arquivo de configuração correto.

O caminho de montagem para a configuração de inicialização do aplicativo PHP. Certifique-se de que o servidor PHP use este arquivo de configuração para inicialização.

O conteúdo do arquivo de configuração do PHP.

A configuração do Tomcat. Defina este parâmetro como "" ou "{}" para excluir a configuração. Valores válidos:

• port: o número da porta. Valores válidos: 1024 a 65535. Portas menores que 1024 requerem permissões de root. Como o contêiner é configurado com permissões de administrador, especifique uma porta maior que 1024. Valor padrão: 8080.

• contextPath: o caminho de acesso. Valor padrão: diretório raiz "/".

• maxThreads: o tamanho do pool de conexões. Valor padrão: 400.

• uriEncoding: o formato de codificação do Tomcat. Valores válidos: UTF-8, ISO-8859-1, GBK e GB2312. Valor padrão: ISO-8859-1.

• useBodyEncodingForUri: especifica se deve usar BodyEncoding for URL. Valor padrão: true.

A descrição da montagem OSS. Configurações de parâmetros:

• bucketName: o nome do bucket.

• bucketPath: a pasta ou objeto criado no OSS. Se a pasta de montagem do OSS não existir, uma exceção será acionada.

• mountPath: o caminho do contêiner no Serverless App Engine. Se o caminho já existir, trata-se de uma relação de sobrescrita. Se o caminho não existir, ele será criado.

• readOnly: especifica se o caminho do contêiner tem permissão somente leitura nos recursos da pasta montada. Valores válidos:

  • true: permissão somente leitura.

  • false: permissão de leitura e gravação.

O AccessKey ID para operações de leitura e gravação no OSS.

O AccessKey Secret para operações de leitura e gravação no OSS.

Especifica se as regras de liberação canary de tráfego devem ser ativadas. Esta regra aplica-se apenas a aplicativos que usam o framework Spring Cloud ou Dubbo. Valores válidos:

• true: ativa as regras de liberação canary.

• false: desativa as regras de liberação canary.

A versão do PHP da qual o pacote de implantação depende. Não suportado para imagens.

O ID da instância Enterprise do Container Registry. Este parâmetro é obrigatório quando ImageUrl está definido como uma imagem de instância Enterprise do Container Registry.

O ARN da função RAM necessária para pull de imagens entre contas. Para mais informações, consulte Grant permissions across Alibaba Cloud accounts by using a RAM role.

O ID do segredo correspondente.

Especifica se um elastic IP address (EIP) deve ser associado. Valores válidos:

• true: associa um EIP.

• false: não associa um EIP.

O resumo das configurações de coleta de logs para Kafka. Valores válidos:

• kafkaEndpoint: o endpoint da API do Kafka.

• kafkaInstanceId: o ID da instância Kafka.

• kafkaConfigs: o resumo da configuração para uma ou mais entradas de log. Para valores de exemplo e descrições de parâmetros, consulte o parâmetro de solicitação kafkaConfigs neste tópico.

Ativa o registro e descoberta de serviços baseados em K8s Service. Valores válidos:

• portProtocols: a porta e o protocolo. Valores válidos de porta: [1,65535]. Valores válidos de protocolo: TCP e UDP.

• portAndProtocol: a porta e o protocolo. Valores válidos de porta: [1,65535]. Valores válidos de protocolo: TCP e UDP. portProtocols é recomendado. Se portProtocols for definido, apenas portProtocols terá efeito.

• enable: ativa o registro e descoberta de serviços baseados em K8s Service.

Configura o registro e descoberta de serviços baseados em K8s Service com liberação canary de ponta a ponta:

• enable: especifica se a liberação canary de ponta a ponta baseada em K8s Service deve ser ativada.

  • true: ativado.

  • false: desativado.

• namespaceId: o ID do namespace.

• portAndProtocol: a porta de escuta e o protocolo. Formato: {"port:protocol type":"container port"}.

• portProtocols: define a porta e o protocolo do serviço.

  • port: a porta.

  • protocol: o protocolo.

  • targetPort: a porta do contêiner.

• pvtzDiscoveryName: o nome da descoberta de serviço.

• serviceId: o ID do serviço.

• serviceName: o nome do serviço.

Especifica o registro Nacos. Valores válidos:

• 0: Nacos integrado do Serverless App Engine.

• 1: Nacos autogerenciado.

• 2: Nacos da edição comercial do Microservices Engine (MSE).

A configuração do registro, que entra em vigor apenas quando o tipo de registro é MSE Nacos Enterprise Edition.

A configuração de montagem do NAS. Valores válidos:

• mountPath: o caminho de montagem do contêiner.

• readOnly: defina como false para permissão de leitura e gravação.

• nasId: o ID do NAS.

• mountDomain: o endereço do ponto de montagem do contêiner. Para mais informações, consulte DescribeMountTargets.

• nasPath: o diretório relativo de arquivos do NAS.

O ambiente Python. PYTHON 3.9.15 é suportado.

As dependências de módulos de instalação personalizada. Por padrão, as dependências definidas no arquivo requirements.txt na pasta raiz são instaladas. Se nenhuma dependência estiver configurada ou se pacotes personalizados forem necessários, você pode especificar as dependências a serem instaladas.

A versão do framework .NET:

• .NET 3.1

• .NET 5.0

• .NET 6.0

• .NET 7.0

• .NET 8.0

Este parâmetro entra em vigor apenas para aplicativos no estado parado. Se você chamar a operação DeployApplication para um aplicativo em execução, o aplicativo será reimplementado imediatamente.

• true: valor padrão. Implanta imediatamente, aplica a nova configuração de implantação e inicia as instâncias.

• false: aplica apenas a nova configuração de implantação, sem iniciar as instâncias do aplicativo.

O tipo de pacote do aplicativo. Valores válidos:

• Ao implantar com Java, os seguintes tipos são suportados: FatJar, War e Image.

• Ao implantar com PHP, os seguintes tipos são suportados:

  • PhpZip

  • IMAGE_PHP_5_4

  • IMAGE_PHP_5_4_ALPINE

  • IMAGE_PHP_5_5

  • IMAGE_PHP_5_5_ALPINE

  • IMAGE_PHP_5_6

  • IMAGE_PHP_5_6_ALPINE

  • IMAGE_PHP_7_0

  • IMAGE_PHP_7_0_ALPINE

  • IMAGE_PHP_7_1

  • IMAGE_PHP_7_1_ALPINE

  • IMAGE_PHP_7_2

  • IMAGE_PHP_7_2_ALPINE

  • IMAGE_PHP_7_3

  • IMAGE_PHP_7_3_ALPINE

• Ao implantar com Python, os seguintes tipos são suportados: PythonZip e Image.

Os recursos de CPU necessários para cada instância. Unidade: millicores. Este parâmetro não pode ser definido como 0. Apenas as seguintes especificações definidas são suportadas:

• 500

• 1000

• 2000

• 4000

• 8000

• 12000

• 16000

• 32000

A memória necessária para cada instância. Unidade: MB. Este parâmetro não pode ser definido como 0. A memória tem um mapeamento um para um com a CPU. Apenas as seguintes especificações definidas são suportadas:

• 1024: corresponde a 500 e 1000 millicores de CPU.

• 2048: corresponde a 500, 1000 e 2000 millicores de CPU.

• 4096: corresponde a 1000, 2000 e 4000 millicores de CPU.

• 8192: corresponde a 2000, 4000 e 8000 millicores de CPU.

• 12288: corresponde a 12000 millicores de CPU.

• 16384: corresponde a 4000, 8000 e 16000 millicores de CPU.

• 24576: corresponde a 12000 millicores de CPU.

• 32768: corresponde a 16000 millicores de CPU.

• 65536: corresponde a 8000, 16000 e 32000 millicores de CPU.

• 131072: corresponde a 32000 millicores de CPU.

O número de instâncias.

O ID do grupo de segurança.

O vSwitch onde residem os controladores de interface de rede (NICs) da instância do aplicativo. O vSwitch deve estar na VPC especificada.

As tags de liberação canary configuradas para o aplicativo.

Especifica se o novo recurso ARMS deve ser ativado:

• true: ativado.

• false: desativado.

Especifica se o recurso CPU Burst deve ser ativado:

• true: ativado.

• false: desativado.

A função RAM para autenticação de identidade.

A descrição da montagem do Secret. Use um segredo criado na página de segredos do namespace para injetar informações confidenciais no contêiner. Configurações:

• secretId: o ID da instância do segredo. Você pode obtê-lo chamando a operação ListSecrets.

• key: a chave.

• mountPath: o caminho de montagem.

Especifica se o isolamento de recursos do sidecar deve ser ativado:

• true: ativa o isolamento.

• false: não ativa o isolamento.

O tipo de imagem personalizada. Se a imagem não for uma imagem personalizada, defina este parâmetro como uma string vazia:

• internet: imagem pública.

• intranet: imagem privada.

Configura a governança de microsserviços.

• Especifica se a governança de microsserviços deve ser ativada (enable):

  • true: ativado.

  • false: desativado.

• Configura online/offline sem perdas (mseLosslessRule):

  • delayTime: o tempo de atraso.

  • enable: especifica se o recurso online sem perdas deve ser ativado. true indica ativado e false indica desativado.

  • notice: especifica se o recurso de notificação deve ser ativado. true indica ativado e false indica desativado.

  • warmupTime: a duração do aquecimento para cenários de baixo tráfego. Unidade: segundos.

A versão do aplicativo:

• lite: edição lite.

• std: edição standard.

• pro: edição professional.

Ativa a sonda de inicialização do aplicativo.

• Verificação bem-sucedida: indica que o aplicativo foi iniciado com sucesso. Se você configurou verificações de Liveness e Readiness, elas serão realizadas após o aplicativo ser iniciado com sucesso.

• Verificação falhou: indica que o aplicativo falhou ao iniciar. Uma exceção é relatada e o aplicativo é reiniciado automaticamente.

Especifica se a coleta personalizada de métricas do Prometheus deve ser ativada.

A versão do Nginx.

• nginx 1.20

• nginx 1.22

• nginx 1.24

• nginx 1.26

• nginx 1.28

A configuração de armazenamento efêmero compartilhado.

A configuração ReadinessGate do gateway ALB.

O número máximo de instâncias de surto. Valores válidos:

Se o número mínimo de instâncias disponíveis for 100%, o surto máximo não pode ser definido como 0. Se este parâmetro for definido como -1, o valor recomendado pelo sistema de 30% será usado, que corresponde a 30% do número atual de instâncias. Por exemplo, se o número atual de instâncias for 10, o valor será 10 × 30% = 3.

A porcentagem máxima de instâncias de surto. Valores válidos:

Se o número mínimo de instâncias disponíveis for 100%, o surto máximo não pode ser definido como 0. Se este parâmetro for definido como -1, o valor recomendado pelo sistema de 30% será usado, que corresponde a 30% do número atual de instâncias. Por exemplo, se o número atual de instâncias for 10, o valor será 10 × 30% = 3.

A versão do AliyunAgent.

Especifica se a configuração da versão do Agent do namespace deve ser reutilizada.

Tags de log do SLS.