sfctl application
Crie, exclua e gerencie aplicativos e tipos de aplicativos.
Comandos
| Comando | Description |
|---|---|
| criar | Cria um aplicativo do Service Fabric usando a descrição especificada. |
| delete | Exclui um aplicativo do Service Fabric existente. |
| implantado | Obtém as informações sobre um aplicativo implantado em um nó do Service Fabric. |
| Integridade implantada | Obtém as informações sobre a integridade de um aplicativo implantado em um nó do Service Fabric. |
| lista implantada | Obtém a lista de aplicativos implantados em um nó do Service Fabric. |
| saúde | Obtém a integridade do aplicativo de malha de serviço. |
| informação | Obtém informações sobre um aplicativo do Service Fabric. |
| list | Obtém a lista de aplicativos criados no cluster do Service Fabric que correspondem aos filtros especificados. |
| carregar | Obtém informações de carregamento sobre um aplicativo do Service Fabric. |
| manifesto | Obtém o manifesto que descreve um tipo de aplicativo. |
| provisão | Provisiona ou registra um tipo de aplicativo do Service Fabric com o cluster usando o pacote '.sfpkg' no repositório externo ou usando o pacote de aplicativo no repositório de imagens. |
| relatório-saúde | Envia um relatório de integridade no aplicativo Service Fabric. |
| tipo | Obtém a lista de tipos de aplicativos no cluster do Service Fabric que correspondem exatamente ao nome especificado. |
| lista de tipos | Obtém a lista de tipos de aplicativos no cluster do Service Fabric. |
| desprovimento | Remove ou cancela o registro de um tipo de aplicativo do Service Fabric do cluster. |
| atualizar | Inicia a atualização de um aplicativo no cluster do Service Fabric. |
| atualização-retomada | Retoma a atualização de um aplicativo no cluster do Service Fabric. |
| upgrade-rollback | Inicia a reversão da atualização atualmente em curso de um aplicativo no cluster do Service Fabric. |
| status de atualização | Obtém detalhes para a atualização mais recente realizada neste aplicativo. |
| upload | Copie um pacote de aplicativo do Service Fabric para o armazenamento de imagens. |
criação de aplicativo sfctl
Cria um aplicativo do Service Fabric usando a descrição especificada.
Argumentos
| Argumento | Description |
|---|---|
| --app-name [Obrigatório] | O nome do aplicativo, incluindo o esquema de URI 'fabric:'. |
| --app-type [Obrigatório] | O nome do tipo de aplicativo encontrado no manifesto do aplicativo. |
| --app-version [Obrigatório] | A versão do tipo de aplicativo, conforme definido no manifesto do aplicativo. |
| --contagem máxima de nós | O número máximo de nós em que o Service Fabric reservará capacidade para este aplicativo. Observe que isso não significa que os serviços deste aplicativo serão colocados em todos esses nós. |
| --métricas | Uma lista codificada JSON de descrições de métricas de capacidade do aplicativo. Uma métrica é definida como um nome, associado a um conjunto de capacidades para cada nó em que o aplicativo existe. |
| --min-node-count | O número mínimo de nós em que o Service Fabric reservará capacidade para este aplicativo. Observe que isso não significa que os serviços deste aplicativo serão colocados em todos esses nós. |
| --parâmetros | Uma lista codificada JSON de parâmetros de aplicativo substitui a ser aplicada ao criar o aplicativo. |
| --tempo limite -t | Padrão: 60. |
Argumentos globais
| Argumento | Description |
|---|---|
| --depuração | Aumente a verbosidade do log para mostrar todos os logs de depuração. |
| --ajuda -h | Mostrar esta mensagem de ajuda e sair. |
| --saída -o | Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json. |
| --consulta | Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos. |
| --verborrágico | Aumente a verbosidade do registro. Use --debug para logs de depuração completos. |
Exclusão de aplicativo SFCTL
Exclui um aplicativo do Service Fabric existente.
Um aplicativo deve ser criado antes de poder ser excluído. A exclusão de um aplicativo excluirá todos os serviços que fazem parte desse aplicativo. Por padrão, o Service Fabric tentará fechar réplicas de serviço de maneira normal e, em seguida, excluirá o serviço. No entanto, se um serviço estiver tendo problemas para fechar a réplica normalmente, a operação de exclusão pode levar muito tempo ou ficar presa. Use o sinalizador opcional ForceRemove para ignorar a sequência de fechamento graciosa e excluir com força o aplicativo e todos os seus serviços.
Argumentos
| Argumento | Description |
|---|---|
| --application-id [Obrigatório] | A identidade do aplicativo. Normalmente, este é o nome completo do aplicativo sem o esquema de URI 'fabric:'. A partir da versão 6.0, os nomes hierárquicos são delimitados com o caractere "~". Por exemplo, se o nome do aplicativo for "fabric:/myapp/app1", a identidade do aplicativo será "myapp~app1" em 6.0+ e "myapp/app1" em versões anteriores. |
| --forçar-remover | Remova um aplicativo ou serviço do Service Fabric com força sem passar pela sequência de desligamento normal. Esse parâmetro pode ser usado para excluir à força um aplicativo ou serviço para o qual a exclusão está expirando devido a problemas no código de serviço que impedem o fechamento normal de réplicas. |
| --tempo limite -t | O tempo limite do servidor para executar a operação em segundos. Esse tempo limite especifica a duração do tempo que o cliente está disposto a aguardar a conclusão da operação solicitada. O valor padrão para esse parâmetro é 60 segundos. Padrão: 60. |
Argumentos globais
| Argumento | Description |
|---|---|
| --depuração | Aumente a verbosidade do log para mostrar todos os logs de depuração. |
| --ajuda -h | Mostrar esta mensagem de ajuda e sair. |
| --saída -o | Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json. |
| --consulta | Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos. |
| --verborrágico | Aumente a verbosidade do registro. Use --debug para logs de depuração completos. |
Aplicativo SFCTL implantado
Obtém as informações sobre um aplicativo implantado em um nó do Service Fabric.
Essa consulta retorna informações do aplicativo do sistema se o ID do aplicativo fornecido for para o aplicativo do sistema. Os resultados abrangem aplicativos implantados em estados ativos, de ativação e download. Esta consulta requer que o nome do nó corresponda a um nó no cluster. A consulta falhará se o nome do nó fornecido não apontar para nenhum nó ativo do Service Fabric no cluster.
Argumentos
| Argumento | Description |
|---|---|
| --application-id [Obrigatório] | A identidade do aplicativo. Normalmente, este é o nome completo do aplicativo sem o esquema de URI 'fabric:'. A partir da versão 6.0, os nomes hierárquicos são delimitados com o caractere "~". Por exemplo, se o nome do aplicativo for "fabric:/myapp/app1", a identidade do aplicativo será "myapp~app1" em 6.0+ e "myapp/app1" em versões anteriores. |
| --node-name [Obrigatório] | O nome do nó. |
| --include-health-state | Inclua o estado de integridade de uma entidade. Se esse parâmetro for falso ou não for especificado, o estado de integridade retornado será "Desconhecido". Quando definida como true, a consulta vai em paralelo ao nó e ao serviço do sistema de integridade antes que os resultados sejam mesclados. Como resultado, a consulta é mais cara e pode levar mais tempo. |
| --tempo limite -t | O tempo limite do servidor para executar a operação em segundos. Esse tempo limite especifica a duração do tempo que o cliente está disposto a aguardar a conclusão da operação solicitada. O valor padrão para esse parâmetro é 60 segundos. Padrão: 60. |
Argumentos globais
| Argumento | Description |
|---|---|
| --depuração | Aumente a verbosidade do log para mostrar todos os logs de depuração. |
| --ajuda -h | Mostrar esta mensagem de ajuda e sair. |
| --saída -o | Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json. |
| --consulta | Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos. |
| --verborrágico | Aumente a verbosidade do registro. Use --debug para logs de depuração completos. |
Integridade implantada do aplicativo SFCTL
Obtém as informações sobre a integridade de um aplicativo implantado em um nó do Service Fabric.
Obtém as informações sobre a integridade de um aplicativo implantado em um nó do Service Fabric. Use EventsHealthStateFilter para, opcionalmente, filtrar a coleção de objetos HealthEvent relatados no aplicativo implantado com base no estado de integridade. Use DeployedServicePackagesHealthStateFilter para, opcionalmente, filtrar crianças DeployedServicePackageHealth com base no estado de integridade.
Argumentos
| Argumento | Description |
|---|---|
| --application-id [Obrigatório] | A identidade do aplicativo. Normalmente, este é o nome completo do aplicativo sem o esquema de URI 'fabric:'. A partir da versão 6.0, os nomes hierárquicos são delimitados com o caractere "~". Por exemplo, se o nome do aplicativo for "fabric:/myapp/app1", a identidade do aplicativo será "myapp~app1" em 6.0+ e "myapp/app1" em versões anteriores. |
| --node-name [Obrigatório] | O nome do nó. |
| --deployed-service-packages-health-state-filter | Permite filtrar os objetos de estado de integridade do pacote de serviço implantado retornados no resultado da consulta de integridade do aplicativo implantado com base em seu estado de integridade. Os valores possíveis para esse parâmetro incluem o valor inteiro de um dos seguintes estados de integridade. Somente os pacotes de serviço implantados que correspondem ao filtro são retornados. Todos os pacotes de serviço implantados são usados para avaliar o estado de integridade agregado do aplicativo implantado. Se não for especificado, todas as entradas serão retornadas. Os valores de estado são enumeração baseada em sinalizador, portanto, o valor pode ser uma combinação desses valores, obtidos usando o operador bit a bit 'OR'. Por exemplo, se o valor fornecido for 6, o estado de integridade dos pacotes de serviço com valor HealthState de OK (2) e Aviso (4) serão retornados. - Default - Valor padrão. Corresponde a qualquer HealthState. O valor é zero. - Nenhum - Filtro que não corresponde a nenhum valor HealthState. Usado para não retornar resultados em uma determinada coleção de estados. O valor é 1. - Ok - Filtro que corresponde à entrada com o valor HealthState Ok. O valor é 2. - Aviso - Filtro que corresponde à entrada com o valor HealthState Warning. O valor é 4. - Erro - Filtro que corresponde à entrada com o valor HealthState Error. O valor é 8. - All - Filtro que corresponde à entrada com qualquer valor HealthState. O valor é 65535. |
| --events-health-state-filter | Permite filtrar a coleção de objetos HealthEvent retornados com base no estado de integridade. Os valores possíveis para esse parâmetro incluem o valor inteiro de um dos seguintes estados de integridade. Somente os eventos que correspondem ao filtro são retornados. Todos os eventos são usados para avaliar o estado de integridade agregado. Se não for especificado, todas as entradas serão retornadas. Os valores de estado são enumeração baseada em sinalizador, de modo que o valor pode ser uma combinação desses valores, obtidos usando o operador bit a bit 'OR'. Por exemplo, se o valor fornecido for 6, todos os eventos com o valor HealthState de OK (2) e Warning (4) serão retornados. - Default - Valor padrão. Corresponde a qualquer HealthState. O valor é zero. - Nenhum - Filtro que não corresponde a nenhum valor HealthState. Usado para não retornar resultados em uma determinada coleção de estados. O valor é 1. - Ok - Filtro que corresponde à entrada com o valor HealthState Ok. O valor é 2. - Aviso - Filtro que corresponde à entrada com o valor HealthState Warning. O valor é 4. - Erro - Filtro que corresponde à entrada com o valor HealthState Error. O valor é 8. - All - Filtro que corresponde à entrada com qualquer valor HealthState. O valor é 65535. |
| --excluir-estatísticas de saúde | Indica se as estatísticas de integridade devem ser retornadas como parte do resultado da consulta. Falso por padrão. As estatísticas mostram o número de entidades crianças no estado de saúde Ok, Aviso e Erro. |
| --tempo limite -t | O tempo limite do servidor para executar a operação em segundos. Esse tempo limite especifica a duração do tempo que o cliente está disposto a aguardar a conclusão da operação solicitada. O valor padrão para esse parâmetro é 60 segundos. Padrão: 60. |
Argumentos globais
| Argumento | Description |
|---|---|
| --depuração | Aumente a verbosidade do log para mostrar todos os logs de depuração. |
| --ajuda -h | Mostrar esta mensagem de ajuda e sair. |
| --saída -o | Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json. |
| --consulta | Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos. |
| --verborrágico | Aumente a verbosidade do registro. Use --debug para logs de depuração completos. |
Lista implantada do aplicativo SFCTL
Obtém a lista de aplicativos implantados em um nó do Service Fabric.
Obtém a lista de aplicativos implantados em um nó do Service Fabric. Os resultados não incluem informações sobre aplicativos do sistema implantados, a menos que explicitamente consultados pela ID. Os resultados abrangem aplicativos implantados em estados ativos, de ativação e download. Esta consulta requer que o nome do nó corresponda a um nó no cluster. A consulta falhará se o nome do nó fornecido não apontar para nenhum nó ativo do Service Fabric no cluster.
Argumentos
| Argumento | Description |
|---|---|
| --node-name [Obrigatório] | O nome do nó. |
| --continuação-token | O parâmetro de token de continuação é usado para obter o próximo conjunto de resultados. Um token de continuação com um valor não vazio é incluído na resposta da API quando os resultados do sistema não cabem em uma única resposta. Quando esse valor é passado para a próxima chamada de API, a API retorna o próximo conjunto de resultados. Se não houver mais resultados, o token de continuação não conterá um valor. O valor desse parâmetro não deve ser codificado por URL. |
| --include-health-state | Inclua o estado de integridade de uma entidade. Se esse parâmetro for falso ou não for especificado, o estado de integridade retornado será "Desconhecido". Quando definida como true, a consulta vai em paralelo ao nó e ao serviço do sistema de integridade antes que os resultados sejam mesclados. Como resultado, a consulta é mais cara e pode levar mais tempo. |
| --max-resultados | O número máximo de resultados a serem retornados como parte das consultas paginadas. Este parâmetro define o limite superior do número de resultados retornados. Os resultados retornados podem ser menores do que os resultados máximos especificados se eles não se encaixarem na mensagem de acordo com as restrições de tamanho máximo de mensagem definidas na configuração. Se esse parâmetro for zero ou não especificado, a consulta paginada incluirá tantos resultados quanto possível que cabem na mensagem de retorno. |
| --tempo limite -t | O tempo limite do servidor para executar a operação em segundos. Esse tempo limite especifica a duração do tempo que o cliente está disposto a aguardar a conclusão da operação solicitada. O valor padrão para esse parâmetro é 60 segundos. Padrão: 60. |
Argumentos globais
| Argumento | Description |
|---|---|
| --depuração | Aumente a verbosidade do log para mostrar todos os logs de depuração. |
| --ajuda -h | Mostrar esta mensagem de ajuda e sair. |
| --saída -o | Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json. |
| --consulta | Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos. |
| --verborrágico | Aumente a verbosidade do registro. Use --debug para logs de depuração completos. |
Estado de funcionamento da aplicação SFCTL
Obtém a integridade do aplicativo de malha de serviço.
Retorna o estado de integridade do aplicativo de malha de serviço. A resposta informa o estado de integridade Ok, Erro ou Aviso. Se a entidade não for encontrada no repositório de integridade, ela retornará Erro.
Argumentos
| Argumento | Description |
|---|---|
| --application-id [Obrigatório] | A identidade do aplicativo. Normalmente, este é o nome completo do aplicativo sem o esquema de URI 'fabric:'. A partir da versão 6.0, os nomes hierárquicos são delimitados com o caractere "~". Por exemplo, se o nome do aplicativo for "fabric:/myapp/app1", a identidade do aplicativo será "myapp~app1" em 6.0+ e "myapp/app1" em versões anteriores. |
| --deployed-applications-health-state-filter | Permite filtrar os objetos de estado de integridade dos aplicativos implantados retornados no resultado da consulta de integridade do aplicativo com base em seu estado de integridade. Os valores possíveis para esse parâmetro incluem o valor inteiro de um dos seguintes estados de integridade. Somente os aplicativos implantados que correspondem ao filtro serão retornados. Todos os aplicativos implantados são usados para avaliar o estado de integridade agregado. Se não for especificado, todas as entradas serão retornadas. Os valores de estado são enumeração baseada em sinalizador, portanto, o valor pode ser uma combinação desses valores, obtidos usando o operador 'OR' bitwise. Por exemplo, se o valor fornecido for 6, o estado de integridade dos aplicativos implantados com o valor HealthState de OK (2) e Warning (4) será retornado. - Default - Valor padrão. Corresponde a qualquer HealthState. O valor é zero. - Nenhum - Filtro que não corresponde a nenhum valor HealthState. Usado para não retornar resultados em uma determinada coleção de estados. O valor é 1. - Ok - Filtro que corresponde à entrada com o valor HealthState Ok. O valor é 2. - Aviso - Filtro que corresponde à entrada com o valor HealthState Warning. O valor é 4. - Erro - Filtro que corresponde à entrada com o valor HealthState Error. O valor é 8. - All - Filtro que corresponde à entrada com qualquer valor HealthState. O valor é 65535. |
| --events-health-state-filter | Permite filtrar a coleção de objetos HealthEvent retornados com base no estado de integridade. Os valores possíveis para esse parâmetro incluem o valor inteiro de um dos seguintes estados de integridade. Somente os eventos que correspondem ao filtro são retornados. Todos os eventos são usados para avaliar o estado de integridade agregado. Se não for especificado, todas as entradas serão retornadas. Os valores de estado são enumeração baseada em sinalizador, de modo que o valor pode ser uma combinação desses valores, obtidos usando o operador bit a bit 'OR'. Por exemplo, se o valor fornecido for 6, todos os eventos com o valor HealthState de OK (2) e Warning (4) serão retornados. - Default - Valor padrão. Corresponde a qualquer HealthState. O valor é zero. - Nenhum - Filtro que não corresponde a nenhum valor HealthState. Usado para não retornar resultados em uma determinada coleção de estados. O valor é 1. - Ok - Filtro que corresponde à entrada com o valor HealthState Ok. O valor é 2. - Aviso - Filtro que corresponde à entrada com o valor HealthState Warning. O valor é 4. - Erro - Filtro que corresponde à entrada com o valor HealthState Error. O valor é 8. - All - Filtro que corresponde à entrada com qualquer valor HealthState. O valor é 65535. |
| --excluir-estatísticas de saúde | Indica se as estatísticas de integridade devem ser retornadas como parte do resultado da consulta. Falso por padrão. As estatísticas mostram o número de entidades crianças no estado de saúde Ok, Aviso e Erro. |
| --serviços-saúde-estado-filtro | Permite filtrar os objetos de estado de integridade de serviços retornados no resultado da consulta de integridade de serviços com base em seu estado de integridade. Os valores possíveis para esse parâmetro incluem o valor inteiro de um dos seguintes estados de integridade. Somente os serviços que correspondem ao filtro são retornados. Todos os serviços são usados para avaliar o estado de saúde agregado. Se não for especificado, todas as entradas serão retornadas. Os valores de estado são enumeração baseada em sinalizador, portanto, o valor pode ser uma combinação desses valores, obtidos usando o operador 'OR' bitwise. Por exemplo, se o valor fornecido for 6, o estado de integridade dos serviços com o valor HealthState de OK (2) e Warning (4) será retornado. - Default - Valor padrão. Corresponde a qualquer HealthState. O valor é zero. - Nenhum - Filtro que não corresponde a nenhum valor HealthState. Usado para não retornar resultados em uma determinada coleção de estados. O valor é 1. - Ok - Filtro que corresponde à entrada com o valor HealthState Ok. O valor é 2. - Aviso - Filtro que corresponde à entrada com o valor HealthState Warning. O valor é 4. - Erro - Filtro que corresponde à entrada com o valor HealthState Error. O valor é 8. - All - Filtro que corresponde à entrada com qualquer valor HealthState. O valor é 65535. |
| --tempo limite -t | O tempo limite do servidor para executar a operação em segundos. Esse tempo limite especifica a duração do tempo que o cliente está disposto a aguardar a conclusão da operação solicitada. O valor padrão para esse parâmetro é 60 segundos. Padrão: 60. |
Argumentos globais
| Argumento | Description |
|---|---|
| --depuração | Aumente a verbosidade do log para mostrar todos os logs de depuração. |
| --ajuda -h | Mostrar esta mensagem de ajuda e sair. |
| --saída -o | Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json. |
| --consulta | Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos. |
| --verborrágico | Aumente a verbosidade do registro. Use --debug para logs de depuração completos. |
Informações sobre o aplicativo SFCTL
Obtém informações sobre um aplicativo do Service Fabric.
Retorna as informações sobre o aplicativo que foi criado ou está em processo de criação no cluster do Service Fabric e cujo nome corresponde ao especificado como parâmetro. A resposta inclui o nome, tipo, status, parâmetros e outros detalhes sobre o aplicativo.
Argumentos
| Argumento | Description |
|---|---|
| --application-id [Obrigatório] | A identidade do aplicativo. Normalmente, este é o nome completo do aplicativo sem o esquema de URI 'fabric:'. A partir da versão 6.0, os nomes hierárquicos são delimitados com o caractere "~". Por exemplo, se o nome do aplicativo for "fabric:/myapp/app1", a identidade do aplicativo será "myapp~app1" em 6.0+ e "myapp/app1" em versões anteriores. |
| --exclude-application-parameters | O sinalizador que especifica se os parâmetros do aplicativo serão excluídos do resultado. |
| --tempo limite -t | O tempo limite do servidor para executar a operação em segundos. Esse tempo limite especifica a duração do tempo que o cliente está disposto a aguardar a conclusão da operação solicitada. O valor padrão para esse parâmetro é 60 segundos. Padrão: 60. |
Argumentos globais
| Argumento | Description |
|---|---|
| --depuração | Aumente a verbosidade do log para mostrar todos os logs de depuração. |
| --ajuda -h | Mostrar esta mensagem de ajuda e sair. |
| --saída -o | Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json. |
| --consulta | Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos. |
| --verborrágico | Aumente a verbosidade do registro. Use --debug para logs de depuração completos. |
Lista de aplicativos SFCTL
Obtém a lista de aplicativos criados no cluster do Service Fabric que correspondem aos filtros especificados.
Obtém as informações sobre os aplicativos que foram criados ou estão em processo de criação no cluster do Service Fabric e correspondem aos filtros especificados. A resposta inclui o nome, tipo, status, parâmetros e outros detalhes sobre o aplicativo. Se os aplicativos não se encaixarem em uma página, uma página de resultados será retornada, bem como um token de continuação, que pode ser usado para obter a próxima página. Os filtros ApplicationTypeName e ApplicationDefinitionKindFilter não podem ser especificados ao mesmo tempo.
Argumentos
| Argumento | Description |
|---|---|
| --aplicação-definição-tipo-filtro | Usado para filtrar em ApplicationDefinitionKind, que é o mecanismo usado para definir um aplicativo do Service Fabric. - Padrão - Valor padrão, que executa a mesma função que selecionar "Todos". O valor é 0. - All - Filtro que corresponde à entrada com qualquer valor ApplicationDefinitionKind. O valor é 65535. - ServiceFabricApplicationDescription - Filtro que corresponde à entrada com o valor ApplicationDefinitionKind ServiceFabricApplicationDescription. O valor é 1. - Compor - Filtro que corresponde à entrada com o valor ApplicationDefinitionKind Compose. O valor é 2. |
| --nome-tipo-aplicativo | O nome do tipo de aplicativo usado para filtrar os aplicativos a serem consultados. Esse valor não deve conter a versão do tipo de aplicativo. |
| --continuação-token | O parâmetro de token de continuação é usado para obter o próximo conjunto de resultados. Um token de continuação com um valor não vazio é incluído na resposta da API quando os resultados do sistema não cabem em uma única resposta. Quando esse valor é passado para a próxima chamada de API, a API retorna o próximo conjunto de resultados. Se não houver mais resultados, o token de continuação não conterá um valor. O valor desse parâmetro não deve ser codificado por URL. |
| --exclude-application-parameters | O sinalizador que especifica se os parâmetros do aplicativo serão excluídos do resultado. |
| --max-resultados | O número máximo de resultados a serem retornados como parte das consultas paginadas. Este parâmetro define o limite superior do número de resultados retornados. Os resultados retornados podem ser menores do que os resultados máximos especificados se eles não se encaixarem na mensagem de acordo com as restrições de tamanho máximo de mensagem definidas na configuração. Se esse parâmetro for zero ou não especificado, a consulta paginada incluirá tantos resultados quanto possível que cabem na mensagem de retorno. |
| --tempo limite -t | O tempo limite do servidor para executar a operação em segundos. Esse tempo limite especifica a duração do tempo que o cliente está disposto a aguardar a conclusão da operação solicitada. O valor padrão para esse parâmetro é 60 segundos. Padrão: 60. |
Argumentos globais
| Argumento | Description |
|---|---|
| --depuração | Aumente a verbosidade do log para mostrar todos os logs de depuração. |
| --ajuda -h | Mostrar esta mensagem de ajuda e sair. |
| --saída -o | Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json. |
| --consulta | Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos. |
| --verborrágico | Aumente a verbosidade do registro. Use --debug para logs de depuração completos. |
Carga do aplicativo SFCTL
Obtém informações de carregamento sobre um aplicativo do Service Fabric.
Retorna as informações de carga sobre o aplicativo que foi criado ou está em processo de criação no cluster do Service Fabric e cujo nome corresponde ao especificado como parâmetro. A resposta inclui o nome, nós mínimos, nós máximos, o número de nós que o aplicativo está ocupando atualmente e informações de métrica de carga do aplicativo sobre o aplicativo.
Argumentos
| Argumento | Description |
|---|---|
| --application-id [Obrigatório] | A identidade do aplicativo. Normalmente, este é o nome completo do aplicativo sem o esquema de URI 'fabric:'. A partir da versão 6.0, os nomes hierárquicos são delimitados com o caractere "~". Por exemplo, se o nome do aplicativo for "fabric:/myapp/app1", a identidade do aplicativo será "myapp~app1" em 6.0+ e "myapp/app1" em versões anteriores. |
| --tempo limite -t | O tempo limite do servidor para executar a operação em segundos. Esse tempo limite especifica a duração do tempo que o cliente está disposto a aguardar a conclusão da operação solicitada. O valor padrão para esse parâmetro é 60 segundos. Padrão: 60. |
Argumentos globais
| Argumento | Description |
|---|---|
| --depuração | Aumente a verbosidade do log para mostrar todos os logs de depuração. |
| --ajuda -h | Mostrar esta mensagem de ajuda e sair. |
| --saída -o | Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json. |
| --consulta | Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos. |
| --verborrágico | Aumente a verbosidade do registro. Use --debug para logs de depuração completos. |
manifesto do aplicativo sfctl
Obtém o manifesto que descreve um tipo de aplicativo.
A resposta contém o XML do manifesto do aplicativo como uma cadeia de caracteres.
Argumentos
| Argumento | Description |
|---|---|
| --application-type-name [Obrigatório] | O nome do tipo de aplicativo. |
| --application-type-version [Obrigatório] | A versão do tipo de aplicativo. |
| --tempo limite -t | O tempo limite do servidor para executar a operação em segundos. Esse tempo limite especifica a duração do tempo que o cliente está disposto a aguardar a conclusão da operação solicitada. O valor padrão para esse parâmetro é 60 segundos. Padrão: 60. |
Argumentos globais
| Argumento | Description |
|---|---|
| --depuração | Aumente a verbosidade do log para mostrar todos os logs de depuração. |
| --ajuda -h | Mostrar esta mensagem de ajuda e sair. |
| --saída -o | Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json. |
| --consulta | Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos. |
| --verborrágico | Aumente a verbosidade do registro. Use --debug para logs de depuração completos. |
Fornecimento de aplicativos SFCTL
Provisiona ou registra um tipo de aplicativo do Service Fabric com o cluster usando o pacote '.sfpkg' no repositório externo ou usando o pacote de aplicativo no repositório de imagens.
Provisiona um tipo de aplicativo do Service Fabric com o cluster. A disposição é necessária antes que quaisquer novos aplicativos possam ser instanciados. A operação de provisionamento pode ser executada no pacote de aplicativo especificado pelo relativePathInImageStore ou usando o URI do '.sfpkg' externo. A menos que --external-provision esteja definido, este comando esperará o provisionamento do armazenamento de imagens.
Argumentos
| Argumento | Description |
|---|---|
| --application-package-download-uri | O caminho para o pacote de aplicativo '.sfpkg' de onde o pacote de aplicativo pode ser baixado usando protocolos HTTP ou HTTPS. Apenas para armazenamento externo do tipo de provisão. O pacote do aplicativo pode ser armazenado em um armazenamento externo que fornece a operação GET para baixar o arquivo. Os protocolos suportados são HTTP e HTTPS, e o caminho deve permitir acesso READ. |
| --application-type-build-path | Apenas para armazenamento de imagens do tipo de provisão. O caminho relativo para o pacote de aplicativo no armazenamento de imagens especificado durante a operação de carregamento anterior. |
| --nome-tipo-aplicativo | Apenas para armazenamento externo do tipo de provisão. O nome do tipo de aplicativo representa o nome do tipo de aplicativo encontrado no manifesto do aplicativo. |
| --application-type-version | Apenas para armazenamento externo do tipo de provisão. A versão do tipo de aplicativo representa a versão do tipo de aplicativo encontrada no manifesto do aplicativo. |
| --provisão externa | O local a partir do qual o pacote de aplicativos pode ser registrado ou provisionado. Indica que a provisão é para um pacote de aplicativo que foi carregado anteriormente em um repositório externo. O pacote de aplicação termina com a extensão *.sfpkg. |
| --não-espera | Indica se o provisionamento deve ou não ocorrer de forma assíncrona. Quando definida como true, a operação de provisionamento retorna quando a solicitação é aceita pelo sistema e a operação de provisionamento continua sem qualquer limite de tempo limite. O valor predefinido é false. Para pacotes de aplicativos grandes, recomendamos definir o valor como true. |
| --tempo limite -t | Padrão: 60. |
Argumentos globais
| Argumento | Description |
|---|---|
| --depuração | Aumente a verbosidade do log para mostrar todos os logs de depuração. |
| --ajuda -h | Mostrar esta mensagem de ajuda e sair. |
| --saída -o | Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json. |
| --consulta | Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos. |
| --verborrágico | Aumente a verbosidade do registro. Use --debug para logs de depuração completos. |
Relatório de integridade do aplicativo SFCTL
Envia um relatório de integridade no aplicativo Service Fabric.
Relata o estado de integridade do aplicativo Service Fabric especificado. O relatório deve conter as informações sobre a fonte do relatório de saúde e a propriedade em que é relatado. O relatório é enviado para um Aplicativo de gateway do Service Fabric, que encaminha para o repositório de integridade. O relatório pode ser aceito pelo gateway, mas rejeitado pelo armazenamento de saúde após validação extra. Por exemplo, o armazenamento de integridade pode rejeitar o relatório devido a um parâmetro inválido, como um número de sequência obsoleto. Para ver se o relatório foi aplicado no repositório de integridade, obtenha a integridade do aplicativo e verifique se o relatório aparece.
Argumentos
| Argumento | Description |
|---|---|
| --application-id [Obrigatório] | A identidade do aplicativo. Normalmente, este é o nome completo do aplicativo sem o esquema de URI 'fabric:'. A partir da versão 6.0, os nomes hierárquicos são delimitados com o caractere '~'. Por exemplo, se o nome do aplicativo for 'fabric:/myapp/app1', a identidade do aplicativo será 'myapp~app1' em 6.0+ e 'myapp/app1' em versões anteriores. |
| --health-property [Obrigatório] | A propriedade das informações de saúde. Uma entidade pode ter relatórios de integridade para propriedades diferentes. A propriedade é uma cadeia de caracteres e não uma enumeração fixa para permitir que o repórter tenha flexibilidade para categorizar a condição de estado que dispara o relatório. Por exemplo, um repórter com SourceId "LocalWatchdog" pode monitorar o estado do disco disponível em um nó, para que possa relatar a propriedade "AvailableDisk" nesse nó. O mesmo repórter pode monitorar a conectividade do nó, para que possa relatar uma propriedade "Conectividade" no mesmo nó. No repositório de integridade, esses relatórios são tratados como eventos de integridade separados para o nó especificado. Juntamente com o SourceId, a propriedade identifica exclusivamente as informações de integridade. |
| --health-state [Obrigatório] | Os valores possíveis incluem: 'Inválido', 'Ok', 'Aviso', 'Erro', 'Desconhecido'. |
| --source-id [Obrigatório] | O nome de origem que identifica o componente cliente/watchdog/system que gerou as informações de integridade. |
| --descrição | A descrição das informações de saúde. Ele representa o texto livre usado para adicionar informações legíveis por humanos sobre o relatório. O comprimento máximo da cadeia de caracteres para a descrição é de 4096 caracteres. Se a cadeia de caracteres fornecida for mais longa, ela será automaticamente truncada. Quando truncado, os últimos caracteres da descrição contêm um marcador "[Truncado]", e o tamanho total da cadeia de caracteres é de 4096 caracteres. A presença do marcador indica aos usuários que ocorreu truncamento. Observe que, quando truncada, a descrição tem menos de 4096 caracteres da cadeia de caracteres original. |
| --imediato | Um sinalizador que indica se o relatório deve ser enviado imediatamente. Um relatório de integridade é enviado para um Aplicativo de gateway do Service Fabric, que encaminha para o repositório de integridade. Se Immediate estiver definido como true, o relatório será enviado imediatamente do HTTP Gateway para o repositório de integridade, independentemente das configurações do cliente de malha que o Aplicativo de Gateway HTTP está usando. Isso é útil para relatórios críticos que devem ser enviados o mais rápido possível. Dependendo do tempo e de outras condições, o envio do relatório ainda pode falhar, por exemplo, se o Gateway HTTP estiver fechado ou se a mensagem não chegar ao Gateway. Se Immediate estiver definido como false, o relatório será enviado com base nas configurações do cliente de integridade do Gateway HTTP. Portanto, ele será lotado de acordo com a configuração HealthReportSendInterval. Essa é a configuração recomendada porque permite que o cliente de integridade otimize as mensagens de relatório de integridade para o armazenamento de integridade, bem como o processamento de relatórios de integridade. Por padrão, os relatórios não são enviados imediatamente. |
| --remover-quando-expirou | Valor que indica se o relatório é removido do armazenamento de integridade quando expira. Se definido como true, o relatório é removido do armazenamento de integridade depois de expirar. Se definido como false, o relatório é tratado como um erro quando expirado. O valor dessa propriedade é false por padrão. Quando os clientes relatam periodicamente, eles devem definir RemoveWhenExpired false (padrão). Desta forma, se o repórter tiver problemas (por exemplo, impasse) e não puder reportar, a entidade é avaliada com erro quando o relatório de saúde expira. Isso sinaliza a entidade como estando no estado de integridade de erro. |
| --número-sequência | O número de sequência para este relatório de integridade como uma cadeia de caracteres numérica. O número de sequência do relatório é usado pelo repositório de integridade para detetar relatórios obsoletos. Se não for especificado, um número de sequência é gerado automaticamente pelo cliente de integridade quando um relatório é adicionado. |
| --tempo limite -t | Padrão: 60. |
| --TTL | A duração durante a qual este relatório de integridade é válido. Este campo usa ISO8601 formato para especificar a duração. Quando os clientes reportam periodicamente, devem enviar relatórios com maior frequência do que o tempo de vida. Se os clientes relatarem a transição, eles podem definir o tempo de vida como infinito. Quando o tempo de vida expira, o evento de integridade que contém as informações de integridade é removido do armazenamento de integridade, se RemoveWhenExpired for true, ou avaliado em erro, se RemoveWhenExpired false. Se não for especificado, o tempo de vida assume como padrão o valor infinito. |
Argumentos globais
| Argumento | Description |
|---|---|
| --depuração | Aumente a verbosidade do log para mostrar todos os logs de depuração. |
| --ajuda -h | Mostrar esta mensagem de ajuda e sair. |
| --saída -o | Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json. |
| --consulta | Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos. |
| --verborrágico | Aumente a verbosidade do registro. Use --debug para logs de depuração completos. |
Tipo de aplicativo SFCTL
Obtém a lista de tipos de aplicativos no cluster do Service Fabric que correspondem exatamente ao nome especificado.
Retorna as informações sobre os tipos de aplicativo que são provisionados ou estão em processo de provisionamento no cluster do Service Fabric. Esses resultados são de tipos de aplicativos cujo nome corresponde exatamente ao especificado como parâmetro e que estão em conformidade com os parâmetros de consulta fornecidos. Todas as versões do tipo de aplicativo correspondentes ao nome do tipo de aplicativo são retornadas, com cada versão retornada como um tipo de aplicativo. A resposta inclui o nome, versão, status e outros detalhes sobre o tipo de aplicativo. Esta é uma consulta paginada, o que significa que, se nem todos os tipos de aplicativo se encaixarem em uma página, uma página de resultados será retornada, bem como um token de continuação, que pode ser usado para obter a próxima página. Por exemplo, se houver 10 tipos de aplicativo, mas uma página se encaixar apenas nos três primeiros tipos de aplicativo, ou se max results for definido como 3, três serão retornados. Para acessar o restante dos resultados, recupere as páginas subsequentes usando o token de continuação retornado na próxima consulta. Um token de continuação vazio é retornado se não houver páginas subsequentes.
Argumentos
| Argumento | Description |
|---|---|
| --application-type-name [Obrigatório] | O nome do tipo de aplicativo. |
| --application-type-version | A versão do tipo de aplicativo. |
| --continuação-token | O parâmetro de token de continuação é usado para obter o próximo conjunto de resultados. Um token de continuação com um valor não vazio é incluído na resposta da API quando os resultados do sistema não cabem em uma única resposta. Quando esse valor é passado para a próxima chamada de API, a API retorna o próximo conjunto de resultados. Se não houver mais resultados, o token de continuação não conterá um valor. O valor desse parâmetro não deve ser codificado por URL. |
| --exclude-application-parameters | O sinalizador que especifica se os parâmetros do aplicativo serão excluídos do resultado. |
| --max-resultados | O número máximo de resultados a serem retornados como parte das consultas paginadas. Este parâmetro define o limite superior do número de resultados retornados. Os resultados retornados podem ser menores do que os resultados máximos especificados se eles não se encaixarem na mensagem de acordo com as restrições de tamanho máximo de mensagem definidas na configuração. Se esse parâmetro for zero ou não especificado, a consulta paginada incluirá tantos resultados quanto possível que cabem na mensagem de retorno. |
| --tempo limite -t | O tempo limite do servidor para executar a operação em segundos. Esse tempo limite especifica a duração do tempo que o cliente está disposto a aguardar a conclusão da operação solicitada. O valor padrão para esse parâmetro é 60 segundos. Padrão: 60. |
Argumentos globais
| Argumento | Description |
|---|---|
| --depuração | Aumente a verbosidade do log para mostrar todos os logs de depuração. |
| --ajuda -h | Mostrar esta mensagem de ajuda e sair. |
| --saída -o | Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json. |
| --consulta | Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos. |
| --verborrágico | Aumente a verbosidade do registro. Use --debug para logs de depuração completos. |
Lista de tipos de aplicativos SFCTL
Obtém a lista de tipos de aplicativos no cluster do Service Fabric.
Retorna as informações sobre os tipos de aplicativo que são provisionados ou estão em processo de provisionamento no cluster do Service Fabric. Cada versão de um tipo de aplicativo é retornada como um tipo de aplicativo. A resposta inclui o nome, versão, status e outros detalhes sobre o tipo de aplicativo. Esta é uma consulta paginada, o que significa que, se nem todos os tipos de aplicativo se encaixarem em uma página, uma página de resultados será retornada, bem como um token de continuação, que pode ser usado para obter a próxima página. Por exemplo, se houver 10 tipos de aplicativo, mas uma página se encaixar apenas nos três primeiros tipos de aplicativo, ou se max results for definido como 3, três serão retornados. Para acessar o restante dos resultados, recupere as páginas subsequentes usando o token de continuação retornado na próxima consulta. Um token de continuação vazio é retornado se não houver páginas subsequentes.
Argumentos
| Argumento | Description |
|---|---|
| --application-type-definition-kind-filter | Usado para filtrar em ApplicationTypeDefinitionKind, que é o mecanismo usado para definir um tipo de aplicativo do Service Fabric. - Padrão - Valor padrão, que executa a mesma função que selecionar "Todos". O valor é 0. - All - Filtro que corresponde à entrada com qualquer valor ApplicationTypeDefinitionKind. O valor é 65535. - ServiceFabricApplicationPackage - Filtro que corresponde à entrada com o valor ApplicationTypeDefinitionKind ServiceFabricApplicationPackage. O valor é 1. - Compor - Filtro que corresponde à entrada com o valor ApplicationTypeDefinitionKind Compose. O valor é 2. |
| --continuação-token | O parâmetro de token de continuação é usado para obter o próximo conjunto de resultados. Um token de continuação com um valor não vazio é incluído na resposta da API quando os resultados do sistema não cabem em uma única resposta. Quando esse valor é passado para a próxima chamada de API, a API retorna o próximo conjunto de resultados. Se não houver mais resultados, o token de continuação não conterá um valor. O valor desse parâmetro não deve ser codificado por URL. |
| --exclude-application-parameters | O sinalizador que especifica se os parâmetros do aplicativo serão excluídos do resultado. |
| --max-resultados | O número máximo de resultados a serem retornados como parte das consultas paginadas. Este parâmetro define o limite superior do número de resultados retornados. Os resultados retornados podem ser menores do que os resultados máximos especificados se eles não se encaixarem na mensagem de acordo com as restrições de tamanho máximo de mensagem definidas na configuração. Se esse parâmetro for zero ou não especificado, a consulta paginada incluirá tantos resultados quanto possível que cabem na mensagem de retorno. |
| --tempo limite -t | O tempo limite do servidor para executar a operação em segundos. Esse tempo limite especifica a duração do tempo que o cliente está disposto a aguardar a conclusão da operação solicitada. O valor padrão para esse parâmetro é 60 segundos. Padrão: 60. |
Argumentos globais
| Argumento | Description |
|---|---|
| --depuração | Aumente a verbosidade do log para mostrar todos os logs de depuração. |
| --ajuda -h | Mostrar esta mensagem de ajuda e sair. |
| --saída -o | Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json. |
| --consulta | Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos. |
| --verborrágico | Aumente a verbosidade do registro. Use --debug para logs de depuração completos. |
Desprovisionamento de aplicativos SFCTL
Remove ou cancela o registro de um tipo de aplicativo do Service Fabric do cluster.
Essa operação só pode ser executada se todas as instâncias de aplicativo do tipo de aplicativo tiverem sido excluídas. Depois que o tipo de aplicativo não for registrado, nenhuma nova instância de aplicativo poderá ser criada para esse tipo de aplicativo específico.
Argumentos
| Argumento | Description |
|---|---|
| --application-type-name [Obrigatório] | O nome do tipo de aplicativo. |
| --application-type-version [Obrigatório] | A versão do tipo de aplicativo, conforme definido no manifesto do aplicativo. |
| --async-parâmetro | O sinalizador que indica se o desprovisionamento deve ou não ocorrer de forma assíncrona. Quando definida como true, a operação de desprovisionamento retorna quando a solicitação é aceita pelo sistema e a operação de desprovisionamento continua sem qualquer limite de tempo limite. O valor predefinido é false. No entanto, recomendamos defini-lo como true para pacotes de aplicativos grandes que foram provisionados. |
| --tempo limite -t | O tempo limite do servidor para executar a operação em segundos. Esse tempo limite especifica a duração do tempo que o cliente está disposto a aguardar a conclusão da operação solicitada. O valor padrão para esse parâmetro é 60 segundos. Padrão: 60. |
Argumentos globais
| Argumento | Description |
|---|---|
| --depuração | Aumente a verbosidade do log para mostrar todos os logs de depuração. |
| --ajuda -h | Mostrar esta mensagem de ajuda e sair. |
| --saída -o | Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json. |
| --consulta | Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos. |
| --verborrágico | Aumente a verbosidade do registro. Use --debug para logs de depuração completos. |
Atualização do aplicativo SFCTL
Inicia a atualização de um aplicativo no cluster do Service Fabric.
Valida os parâmetros de atualização do aplicativo fornecidos e inicia a atualização do aplicativo se os parâmetros forem válidos. Observe que a descrição da atualização substitui a descrição do aplicativo existente. Isso significa que, se os parâmetros não forem especificados, os parâmetros existentes nos aplicativos serão substituídos pela lista de parâmetros vazia. Isso resultaria no aplicativo usando o valor padrão dos parâmetros do manifesto do aplicativo.
Argumentos
| Argumento | Description |
|---|---|
| --application-id [Obrigatório] | A identidade do aplicativo. Normalmente, este é o nome completo do aplicativo sem o esquema de URI 'fabric:'. A partir da versão 6.0, os nomes hierárquicos são delimitados com o caractere "~". Por exemplo, se o nome do aplicativo for "fabric:/myapp/app1", a identidade do aplicativo será "myapp~app1" em 6.0+ e "myapp/app1" em versões anteriores. |
| --application-version [Obrigatório] | A versão do tipo de aplicativo de destino (encontrada no manifesto do aplicativo) para a atualização do aplicativo. |
| --parameters [Obrigatório] | Uma lista codificada JSON de substituições de parâmetros de aplicativo a serem aplicadas ao atualizar o aplicativo. |
| --default-service-health-policy | Especificação codificada por JSON da diretiva de integridade usada por padrão para avaliar a integridade de um tipo de serviço. |
| --falha-ação | A ação a ser executada quando uma atualização monitorada encontra violações de política de monitoramento ou de diretivas de integridade. |
| --forçar-reiniciar | Reinicie os processos com força durante a atualização, mesmo quando a versão do código não tiver sido alterada. |
| --saúde-check-retry-timeout | O período de tempo entre as tentativas de executar verificações de integridade se o aplicativo ou cluster não estiver íntegro. Padrão: PT0H10M0S. |
| --health-check-stable-duration | A quantidade de tempo que o aplicativo ou cluster deve permanecer íntegro antes que a atualização prossiga para o próximo domínio de atualização. Padrão: PT0H2M0S. É primeiramente interpretada como uma cadeia de caracteres que representa uma duração ISO 8601. Se isso falhar, então é interpretado como um número que representa o número total de milissegundos. |
| --saúde-check-wait-duration | O período de tempo de espera após a conclusão de um domínio de atualização antes de iniciar o processo de verificações de integridade. Predefinição: 0. |
| --max-unhealthy-apps | A porcentagem máxima permitida de aplicativos implantados não íntegros. Representado como um número entre 0 e 100. |
| --modo | O modo usado para monitorar a integridade durante uma atualização contínua. Padrão: UnmonitoredAuto. |
| --réplica-set-check-timeout | A quantidade máxima de tempo para bloquear o processamento de um domínio de atualização e evitar a perda de disponibilidade quando há problemas inesperados. Medido em segundos. |
| --serviço-saúde-política | Mapa codificado JSON com política de integridade do tipo de serviço por nome de tipo de serviço. O mapa está vazio ser padrão. |
| --tempo limite -t | Padrão: 60. |
| --upgrade-domínio-timeout | A quantidade de tempo que cada domínio de atualização tem que ser concluído antes que FailureAction seja executado. Padrão: P10675199DT02H48M05.4775807S. É primeiramente interpretada como uma cadeia de caracteres que representa uma duração ISO 8601. Se isso falhar, então é interpretado como um número que representa o número total de milissegundos. |
| --tempo limite de atualização | A quantidade de tempo que a atualização geral tem que ser concluída antes que FailureAction seja executado. Padrão: P10675199DT02H48M05.4775807S. É primeiramente interpretada como uma cadeia de caracteres que representa uma duração ISO 8601. Se isso falhar, então é interpretado como um número que representa o número total de milissegundos. |
| --aviso-como-erro | Indica se os avisos são tratados com a mesma gravidade que os erros. |
Argumentos globais
| Argumento | Description |
|---|---|
| --depuração | Aumente a verbosidade do log para mostrar todos os logs de depuração. |
| --ajuda -h | Mostrar esta mensagem de ajuda e sair. |
| --saída -o | Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json. |
| --consulta | Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos. |
| --verborrágico | Aumente a verbosidade do registro. Use --debug para logs de depuração completos. |
Atualização-retomada do aplicativo SFCTL
Retoma a atualização de um aplicativo no cluster do Service Fabric.
Retoma uma atualização manual não monitorada do aplicativo Service Fabric. O Service Fabric atualiza um domínio de atualização de cada vez. Para atualizações manuais não monitoradas, depois que o Service Fabric concluir um domínio de atualização, ele aguarda que você chame essa API antes de prosseguir para o próximo domínio de atualização.
Argumentos
| Argumento | Description |
|---|---|
| --application-id [Obrigatório] | A identidade do aplicativo. Normalmente, este é o nome completo do aplicativo sem o esquema de URI 'fabric:'. A partir da versão 6.0, os nomes hierárquicos são delimitados com o caractere "~". Por exemplo, se o nome do aplicativo for "fabric:/myapp/app1", a identidade do aplicativo será "myapp~app1" em 6.0+ e "myapp/app1" em versões anteriores. |
| --upgrade-domain-name [Obrigatório] | O nome do domínio de atualização no qual retomar a atualização. |
| --tempo limite -t | O tempo limite do servidor para executar a operação em segundos. Esse tempo limite especifica a duração do tempo que o cliente está disposto a aguardar a conclusão da operação solicitada. O valor padrão para esse parâmetro é 60 segundos. Padrão: 60. |
Argumentos globais
| Argumento | Description |
|---|---|
| --depuração | Aumente a verbosidade do log para mostrar todos os logs de depuração. |
| --ajuda -h | Mostrar esta mensagem de ajuda e sair. |
| --saída -o | Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json. |
| --consulta | Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos. |
| --verborrágico | Aumente a verbosidade do registro. Use --debug para logs de depuração completos. |
Upgrade-rollback de aplicativos SFCTL
Inicia a reversão da atualização atualmente em curso de um aplicativo no cluster do Service Fabric.
Começa a reverter a atualização do aplicativo atual para a versão anterior. Essa API só pode ser usada para reverter a atualização atual em andamento que está rolando para a nova versão. Se o aplicativo não estiver sendo atualizado no momento, use a API StartApplicationUpgrade para atualizá-lo para a versão desejada, incluindo a reversão para uma versão anterior.
Argumentos
| Argumento | Description |
|---|---|
| --application-id [Obrigatório] | A identidade do aplicativo. Normalmente, este é o nome completo do aplicativo sem o esquema de URI 'fabric:'. A partir da versão 6.0, os nomes hierárquicos são delimitados com o caractere "~". Por exemplo, se o nome do aplicativo for "fabric:/myapp/app1", a identidade do aplicativo será "myapp~app1" em 6.0+ e "myapp/app1" em versões anteriores. |
| --tempo limite -t | O tempo limite do servidor para executar a operação em segundos. Esse tempo limite especifica a duração do tempo que o cliente está disposto a aguardar a conclusão da operação solicitada. O valor padrão para esse parâmetro é 60 segundos. Padrão: 60. |
Argumentos globais
| Argumento | Description |
|---|---|
| --depuração | Aumente a verbosidade do log para mostrar todos os logs de depuração. |
| --ajuda -h | Mostrar esta mensagem de ajuda e sair. |
| --saída -o | Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json. |
| --consulta | Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos. |
| --verborrágico | Aumente a verbosidade do registro. Use --debug para logs de depuração completos. |
Status de atualização do aplicativo SFCTL
Obtém detalhes para a atualização mais recente realizada neste aplicativo.
Retorna informações sobre o estado da atualização mais recente do aplicativo, juntamente com detalhes para ajudar na depuração de problemas de integridade do aplicativo.
Argumentos
| Argumento | Description |
|---|---|
| --application-id [Obrigatório] | A identidade do aplicativo. Normalmente, este é o nome completo do aplicativo sem o esquema de URI 'fabric:'. A partir da versão 6.0, os nomes hierárquicos são delimitados com o caractere "~". Por exemplo, se o nome do aplicativo for "fabric:/myapp/app1", a identidade do aplicativo será "myapp~app1" em 6.0+ e "myapp/app1" em versões anteriores. |
| --tempo limite -t | O tempo limite do servidor para executar a operação em segundos. Esse tempo limite especifica a duração do tempo que o cliente está disposto a aguardar a conclusão da operação solicitada. O valor padrão para esse parâmetro é 60 segundos. Padrão: 60. |
Argumentos globais
| Argumento | Description |
|---|---|
| --depuração | Aumente a verbosidade do log para mostrar todos os logs de depuração. |
| --ajuda -h | Mostrar esta mensagem de ajuda e sair. |
| --saída -o | Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json. |
| --consulta | Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos. |
| --verborrágico | Aumente a verbosidade do registro. Use --debug para logs de depuração completos. |
Upload de aplicativo SFCTL
Copie um pacote de aplicativo do Service Fabric para o armazenamento de imagens.
Opcionalmente, exiba o progresso do upload para cada arquivo no pacote. O progresso do carregamento é enviado para stderr.
Argumentos
| Argumento | Description |
|---|---|
| --caminho [Obrigatório] | Caminho para o pacote de aplicativo local. |
| --comprimir | Aplicável apenas a pacotes de aplicativos do Service Fabric. Crie uma nova pasta contendo o pacote de aplicativo compactado para o local padrão ou para o local especificado pelo parâmetro compacted-location e, em seguida, carregue a pasta recém-criada. Se já houver um arquivo compactado gerado pelo sfctl, ele será substituído se esse sinalizador estiver definido. Um erro será retornado se o diretório não for um pacote de aplicativo. Se já for um pacote de aplicativo compactado, a pasta será copiada como está. Por padrão, o pacote de aplicativo compactado recém-criado será excluído após um carregamento bem-sucedido. Se o upload não for bem-sucedido, limpe manualmente o pacote compactado conforme necessário. A exclusão não remove nenhum dir vazio que possa ter sido criado se o parâmetro location compactado fizer referência a diretórios inexistentes. |
| --localização compactada | O local para colocar o pacote de aplicativos compactados. Se nenhum local for fornecido, o pacote compactado será colocado em uma pasta recém-criada chamada sfctl_compressed_temp sob o diretório pai especificado no argumento path. Por exemplo, se o argumento path tiver o valor C:/FolderA/AppPkg, o pacote compactado será adicionado a C:/FolderA/sfctl_compressed_temp/AppPkg. |
| --imagestore-string | Armazenamento de imagens de destino para o qual carregar o pacote do aplicativo. Padrão: fabric:ImageStore. Para carregar para um local de arquivo, inicie este parâmetro com 'file:'. Caso contrário, o valor deve ser a cadeia de conexão de armazenamento de imagem, como o valor padrão. |
| --manter-comprimido | Se deve ou não manter o pacote compactado gerado após a conclusão bem-sucedida do upload. Se não estiver definido, após a conclusão bem-sucedida, os pacotes de aplicativos compactados serão excluídos. Se o upload não foi bem-sucedido, o pacote do aplicativo sempre será mantido no diretório de saída para reupload. |
| --mostrar-progresso | Mostrar o progresso do carregamento de arquivos para pacotes grandes. |
| --tempo limite -t | O tempo limite total em segundos. O upload falhará e retornará o erro após a duração do tempo limite de upload ter passado. Esse tempo limite se aplica a todo o pacote do aplicativo, e os tempos limite de arquivo individuais serão iguais à duração do tempo limite restante. O tempo limite não inclui o tempo necessário para compactar o pacote do aplicativo. Padrão: 300. |
Argumentos globais
| Argumento | Description |
|---|---|
| --depuração | Aumente a verbosidade do log para mostrar todos os logs de depuração. |
| --ajuda -h | Mostrar esta mensagem de ajuda e sair. |
| --saída -o | Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json. |
| --consulta | Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos. |
| --verborrágico | Aumente a verbosidade do registro. Use --debug para logs de depuração completos. |