Todos os produtos
Search

Este produto

    Enterprise Distributed Application Service:DeployApplication

    Central de documentação

    Enterprise Distributed Application Service:DeployApplication

    Última atualização: Jun 28, 2026

    Implanta um aplicativo em um cluster do Elastic Compute Service (ECS).

    Descrição da operação

    Nota

    Para implantar um aplicativo em um cluster do Container Service for Kubernetes (ACK) que foi importado para o Enterprise Distributed Application Service (EDAS), chame a operação DeployK8sApplication fornecida pelo EDAS. Para obter mais informações, consulte DeployK8sApplication.

    Experimente agora

    Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

    Testar

    Autorização RAM

    A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

    • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

    • API: A API que você pode chamar para executar a ação.

    • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

    • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

      • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

      • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

    • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

    • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

    Ação

    Nível de acesso

    Tipo de recurso

    Chave de condição

    Ação dependente

    edas:ManageApplication

    none

    *Application

    acs:edas:{#regionId}:{#accountId}:namespace/{#NameSpaceId}/application/{#AppId}

    		 Nenhuma Nenhuma

    Sintaxe da solicitação

    POST /pop/v5/changeorder/co_deploy HTTP/1.1

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    AppId

    string

    Sim

    O ID do aplicativo. Você pode chamar a operação ListApplication para consultar o ID do aplicativo. Para obter mais informações, consulte ListApplication.

    3616cdca-********************
    PackageVersion

    string

    Sim

    A versão do pacote de implantação do aplicativo. O valor pode ter até 64 caracteres. Recomendamos o uso de um timestamp.

    1.0
    Desc

    string

    Não

    A descrição da implantação do aplicativo.

    Deploy by edas pop api
    DeployType

    string

    Sim

    O modo de implantação do aplicativo. Valores válidos: url e image. O valor image foi descontinuado. Você pode implantar um aplicativo em um cluster Swarm apenas usando uma imagem.

    URL
    WarUrl

    string

    Não

    A URL do pacote de implantação do aplicativo. O pacote pode ser um pacote WAR ou JAR. Este parâmetro é obrigatório se você definir o parâmetro DeployType como url. Recomendamos que você especifique a URL de um pacote de implantação de aplicativo armazenado em um bucket do Object Storage Service (OSS).

    https://edas.oss-cn-hangzhou.aliyuncs.com/demo/hello-edas.war
    ImageUrl

    string

    Não

    A URL da imagem do aplicativo usada para implantar o aplicativo em um cluster Swarm. Recomendamos que você use uma imagem armazenada no Alibaba Cloud Container Registry. Este parâmetro foi descontinuado.

    registry.cn-hangzhou.aliyuncs.com/mw/testapp:latest
    GroupId

    string

    Sim

    O ID do grupo de instâncias para o qual o aplicativo é implantado. Você pode chamar a operação ListDeployGroup para consultar o ID do grupo de instâncias. Para obter mais informações, consulte ListDeployGroup.

    Defina o parâmetro como all se quiser implantar o aplicativo em todos os grupos de instâncias.

    all
    Batch

    integer

    Não

    O número de lotes por grupo de instâncias.

    • Se você especificar um ID ao definir o parâmetro GroupId, o aplicativo será implantado no grupo de instâncias especificado. O número mínimo de lotes que pode ser especificado é 1. O número máximo de lotes é o número máximo de instâncias ECS no estado Normal no grupo de instâncias. O valor real está no intervalo de [1, número especificado]. O número especificado de lotes é igual ao número de instâncias ECS no grupo de instâncias especificado.

    • Se você definir o parâmetro GroupId como all, o aplicativo será implantado em todos os grupos de instâncias. O número mínimo de lotes que pode ser especificado é 1. O número máximo de lotes é o número de instâncias ECS no grupo de instâncias que possui o maior número de instâncias ECS no estado Normal.

    1
    BatchWaitTime

    integer

    Não

    O tempo de espera entre os lotes de implantação do aplicativo. Unidade: minutos.

    • Valor padrão: 0. Se não for necessário tempo de espera entre os lotes de implantação, defina este parâmetro como 0.

    • Valor máximo: 5.

    Se muitos lotes de implantação forem necessários, recomendamos que você especifique um valor pequeno para este parâmetro. Caso contrário, a implantação do aplicativo será demorada.

    0
    AppEnv

    string

    Não

    As variáveis de ambiente do aplicativo. Especifique cada variável de ambiente usando dois pares chave-valor. Exemplo: {"name":"x","value":"y"},{"name":"x2","value":"y2"}. As chaves dos dois pares chave-valor são name e value.

    [{\"name\":\"env_name_1\", \"value\":\"env_value_1\"}, {\"name\":\"env_name_2\",\"value\":\"env_value_2\"}]
    BuildPackId

    integer

    Não

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

    • Você não precisa definir o parâmetro se não precisar alterar a versão do EDAS Container durante a implantação.

    • Defina o parâmetro se precisar atualizar a versão do EDAS Container do aplicativo durante a implantação.

    Você pode consultar o número do pacote de compilação usando um dos seguintes métodos:

    • Chame a operação ListBuildPack. Para obter mais informações, consulte ListBuildPack.

    • Obtenha o valor na coluna Número do pacote de compilação do tópico Notas de versão do EDAS Container. Por exemplo, 59 indica EDAS Container 3.5.8.

    59
    ComponentIds

    string

    Não

    Os IDs dos componentes usados pelo aplicativo. O parâmetro não se aplica a aplicativos High-Speed Framework (HSF). Você pode chamar a operação ListComponents para consultar os IDs dos componentes. Para obter mais informações, consulte ListComponents.

    • Se você especificou os IDs dos componentes ao criar o aplicativo, não precisa definir o parâmetro ao implantar o aplicativo.

    • Defina o parâmetro se precisar atualizar as versões dos componentes para o aplicativo durante a implantação.

    Valores válidos para componentes comuns de aplicativos:

    • 4: Apache Tomcat 7.0.91

    • 7: Apache Tomcat 8.5.42

    • 5: OpenJDK 1.8.x

    • 6: OpenJDK 1.7.x

    Para obter mais informações, consulte a seção Parâmetros comuns de aplicativos do tópico InsertApplication.

    7
    ReleaseType

    integer

    Não

    O modo pelo qual os lotes de implantação são acionados. Valores válidos:

    • 0: automático.

    • 1: Você deve acionar manualmente o próximo lote. Você pode clicar manualmente em Prosseguir para o próximo lote no console ou chamar a operação ContinuePipeline para prosseguir para o próximo lote. Recomendamos que você escolha o modo automático ao chamar uma operação de API para implantar o aplicativo. Para obter mais informações, consulte ContinuePipeline.

    0
    Gray

    boolean

    Não

    Especifica se a liberação canário é selecionada como o método de implantação. Valores válidos:

    • true: A liberação canário é selecionada.

      • Para implementar uma liberação canário, especifique o parâmetro GroupId, que especifica o ID do grupo de instâncias para a liberação canário.

      • A liberação canário pode ser selecionada como método de implantação para apenas um lote.

      • Após a conclusão da liberação canário, o aplicativo é liberado no modo regular. O parâmetro Batch especifica o número de lotes.

    • false: A liberação em lote único ou a liberação faseada é selecionada.

    true
    TrafficControlStrategy

    string

    Não

    A política de liberação canário. Para obter mais informações sobre as políticas de liberação canário, consulte DeployK8sApplication.

    {"http":{"rules":[{"conditionType":"percent","percent":10}]}}

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    Code

    integer

    O código de status HTTP retornado.

    200
    ChangeOrderId

    string

    O ID do processo de alteração da implantação do aplicativo.

    adf86823-055b-48a4-a59f-fa5582******
    Message

    string

    A mensagem retornada para a solicitação.

    success
    RequestId

    string

    O ID da solicitação.

    d6834ee9-5045-*************

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "Code": 200,
  "ChangeOrderId": "adf86823-055b-48a4-a59f-fa5582******",
  "Message": "success",
  "RequestId": "d6834ee9-5045-*************"
}

    Códigos de erro

    Consulte Códigos de ErroCódigos de Erro para uma lista completa.

    Notas de versão

    Consulte Notas de VersãoNotas de Versão para uma lista completa.