sfctl cluster
Selecione, gerencie e opere clusters do Service Fabric.
Comandos
| Comando | Description |
|---|---|
| Versões de código | Obtém uma lista de versões de código de malha que são provisionadas em um cluster do Service Fabric. |
| config-versões | Obtém uma lista de versões de configuração de malha que são provisionadas em um cluster do Service Fabric. |
| saúde | Obtém a integridade de um cluster do Service Fabric. |
| manifesto | Obtenha o manifesto do cluster do Service Fabric. |
| operação-cancelamento | Cancela uma operação de falha induzida pelo usuário. |
| lista de operações | Obtém uma lista de operações de falha induzidas pelo usuário filtradas pela entrada fornecida. |
| provisão | Provisione o código ou os pacotes de configuração de um cluster do Service Fabric. |
| sistema de recuperação | Indica ao cluster do Service Fabric que ele deve tentar recuperar os serviços do sistema que estão atualmente presos na perda de quórum. |
| relatório-saúde | Envia um relatório de integridade no cluster do Service Fabric. |
| selecione | Conecta-se a um ponto de extremidade de cluster do Service Fabric. |
| show-conexão | Mostrar a qual cluster do Service Fabric essa instância sfctl está conectada. |
| desprovimento | Desprovisione o código ou os pacotes de configuração de um cluster do Service Fabric. |
| atualizar | Comece a atualizar o código ou a versão de configuração de um cluster do Service Fabric. |
| atualização-retomada | Faça com que a atualização do cluster passe para o próximo domínio de atualização. |
| upgrade-rollback | Reverter a atualização de um cluster do Service Fabric. |
| status de atualização | Obtém o progresso da atualização de cluster atual. |
| atualização-atualização | Atualize os parâmetros de atualização de uma atualização de cluster do Service Fabric. |
Versões de código do cluster SFCTL
Obtém uma lista de versões de código de malha que são provisionadas em um cluster do Service Fabric.
Obtém uma lista de informações sobre versões de código de malha que são provisionadas no cluster. O parâmetro CodeVersion pode ser usado para, opcionalmente, filtrar a saída apenas para essa versão específica.
Argumentos
| Argumento | Description |
|---|---|
| --código-versão | A versão do produto do Service Fabric. |
| --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. |
Versões de configuração do cluster SFCTL
Obtém uma lista de versões de configuração de malha que são provisionadas em um cluster do Service Fabric.
Obtém uma lista de informações sobre versões de configuração de malha que são provisionadas no cluster. O parâmetro ConfigVersion pode ser usado para, opcionalmente, filtrar a saída apenas para essa versão específica.
Argumentos
| Argumento | Description |
|---|---|
| --config-versão | A versão de configuração do Service Fabric. |
| --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 do cluster SFCTL
Obtém a integridade de um cluster do Service Fabric.
Use EventsHealthStateFilter para filtrar a coleção de eventos de integridade relatados no cluster com base no estado de integridade. Da mesma forma, use NodesHealthStateFilter e ApplicationsHealthStateFilter para filtrar a coleção de nós e aplicativos retornados com base em seu estado de integridade agregado.
Argumentos
| Argumento | Description |
|---|---|
| --applications-health-state-filter | Permite filtrar os objetos de estado de integridade do aplicativo retornados no resultado da consulta de integridade do cluster com base em seu estado de integridade. Os valores possíveis para esse parâmetro incluem valor inteiro obtido de membros ou operações bit a bit em membros da enumeração HealthStateFilter. Somente os aplicativos que correspondem ao filtro são retornados. Todos os aplicativos 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 com 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. |
| --include-system-application-health-statistics | Indica se as estatísticas de integridade devem incluir as estatísticas de integridade do aplicativo mal:/System. Falso por padrão. Se IncludeSystemApplicationHealthStatistics estiver definido como true, as estatísticas de integridade incluirão as entidades que pertencem ao aplicativo fabric:/System. Caso contrário, o resultado da consulta inclui estatísticas de integridade apenas para aplicativos de usuário. As estatísticas de integridade devem ser incluídas no resultado da consulta para que esse parâmetro seja aplicado. |
| --nós-saúde-estado-filtro | Permite filtrar os objetos de estado de integridade do nó retornados no resultado da consulta de integridade do cluster 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 nós que correspondem ao filtro são retornados. Todos os nós 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 nós 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. |
Manifesto do cluster SFCTL
Obtenha o manifesto do cluster do Service Fabric.
Obtenha o manifesto do cluster do Service Fabric. O manifesto do cluster contém propriedades do cluster que incluem diferentes tipos de nó no cluster, configurações de segurança, falhas e topologias de domínio de atualização, etc. Essas propriedades são especificadas como parte do arquivo ClusterConfig.JSON durante a implantação de um cluster autônomo. No entanto, a maioria das informações no manifesto do cluster é gerada internamente pela malha de serviço durante a implantação do cluster em outros cenários de implantação (por exemplo, ao usar o portal do Azure). O conteúdo do manifesto do cluster é apenas para fins informativos e não se espera que os usuários dependam do formato do conteúdo do arquivo ou de sua interpretação.
Argumentos
| Argumento | Description |
|---|---|
| --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. |
Operação-cancelamento da operação do cluster SFCTL
Cancela uma operação de falha induzida pelo usuário.
As APIs a seguir iniciam operações de falha que podem ser canceladas usando CancelOperation: StartDataLoss, StartQuorumLoss, StartPartitionRestart, StartNodeTransition. Se force for false, a operação induzida pelo usuário especificada será normalmente interrompida e limpa. Se a força for verdadeira, o comando será abortado e algum estado interno poderá ser deixado para trás. Especificar a força como verdadeira deve ser usado com cuidado. Chamar essa API com force definida como true não é permitido até que essa API já tenha sido chamada no mesmo comando de teste com force definida como false primeiro, ou a menos que o comando test já tenha um OperationState de OperationState.RollingBack. Esclarecimento: OperationState.RollingBack significa que o sistema estará/está limpando o estado interno do sistema causado pela execução do comando. Ele não restaurará dados se o comando test for para causar perda de dados. Por exemplo, se você chamar StartDataLoss e chamar essa API, o sistema só limpará o estado interno da execução do comando. Ele não restaurará os dados da partição de destino, se o comando progrediu o suficiente para causar perda de dados. Nota importante: se esta API for invocada com força==true, o estado interno pode ser deixado para trás.
Argumentos
| Argumento | Description |
|---|---|
| --operation-id [Obrigatório] | Um GUID que identifica uma chamada dessa API. Isso é passado para a API GetProgress correspondente. |
| --força | Indica se o estado do sistema interno modificado pela execução da operação induzida pelo usuário deve ser revertido e limpo normalmente. |
| --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 operações do cluster SFCTL
Obtém uma lista de operações de falha induzidas pelo usuário filtradas pela entrada fornecida.
Obtém a lista de operações de falha induzidas pelo usuário filtrada pela entrada fornecida.
Argumentos
| Argumento | Description |
|---|---|
| --estado-filtro | Usado para filtrar OperationState para operações induzidas pelo usuário. - 65535 - selecione Tudo - 1 - selecione Running - 2 - selecione RollingBack - 8 - selecione Concluído - 16 - selecione Defeituoso - 32 - selecione Cancelado - 64 - selecione ForceCancelled. Padrão: 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. |
| --tipo-filtro | Usado para filtrar OperationType para operações induzidas pelo usuário. - 65535 - selecione todos - 1 - selecione PartitionDataLoss. - 2 - selecione PartitionQuorumLoss. - 4 - selecione PartitionRestart. - 8 - selecione NodeTransition. Padrão: 65535. |
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 cluster SFCTL
Provisione o código ou os pacotes de configuração de um cluster do Service Fabric.
Valide e provisione o código ou os pacotes de configuração de um cluster do Service Fabric.
Argumentos
| Argumento | Description |
|---|---|
| --cluster-manifest-file-path | O caminho do arquivo de manifesto do cluster. |
| --código-arquivo-caminho | O caminho do arquivo do pacote de código do cluster. |
| --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. |
Sistema de recuperação de cluster SFCTL
Indica ao cluster do Service Fabric que ele deve tentar recuperar os serviços do sistema que estão atualmente presos na perda de quórum.
Indica ao cluster do Service Fabric que ele deve tentar recuperar os serviços do sistema que estão atualmente presos na perda de quórum. Essa operação só deve ser executada se for sabido que as réplicas que estão inativas não podem ser recuperadas. O uso incorreto desta API pode causar perda potencial de dados.
Argumentos
| Argumento | Description |
|---|---|
| --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 do relatório de cluster SFCTL
Envia um relatório de integridade no cluster do Service Fabric.
Envia um relatório de integridade em um cluster do Service Fabric. 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 nó 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, execute GetClusterHealth e verifique se o relatório aparece na seção HealthEvents.
Argumentos
| Argumento | Description |
|---|---|
| --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. |
Seleção de cluster SFCTL
Conecta-se a um ponto de extremidade de cluster do Service Fabric.
Se estiver se conectando a um cluster seguro, especifique um caminho absoluto para um certificado (.crt) e um arquivo de chave (.key) ou um único arquivo com ambos (.pem). Não especifique ambos. Opcionalmente, se estiver se conectando a um cluster seguro, especifique também um caminho absoluto para um arquivo de pacote de CA ou diretório de certificados de CA confiáveis. Não há conexão com um cluster sem executar esse comando primeiro, incluindo uma conexão com localhost. No entanto, nenhum ponto de extremidade explícito é necessário para se conectar a um cluster local. Se estiver usando um certificado autoassinado ou outro certificado não assinado por uma autoridade de certificação conhecida, passe o parâmetro --ca para garantir que a validação seja aprovada. Se não estiver em um cluster de produção, para ignorar a validação do lado do cliente (útil para CA autoassinada ou assinada não conhecida), use a opção --no-check. Embora possível, não é recomendado para clusters de produção. Um erro de verificação de certificado pode resultar de outra forma.
Argumentos
| Argumento | Description |
|---|---|
| --AAD | Use o Microsoft Entra ID para autenticação. |
| --CA | Caminho absoluto para o diretório de certificados de autoridade de certificação para tratar como arquivo de pacote de autoridade de certificação válido ou válido. Se estiver usando um diretório de certificados de CA, fornecido pelo OpenSSL, c_rehash <directory> deve ser executado primeiro para calcular os hashes de certificado e criar os links simbólicos apropriados. Isso é usado para verificar se o certificado retornado pelo cluster é válido. |
| --cert | Caminho absoluto para um arquivo de certificado de cliente. |
| --parâmetro | URL do ponto de extremidade do cluster, incluindo porta e prefixo HTTP ou HTTPS. Normalmente, o ponto de extremidade terá a aparência de https\://<your-url>\:19080. Se nenhum ponto de extremidade for fornecido, o padrão será .http\://localhost\:19080 |
| --chave | Caminho absoluto para o arquivo de chave de certificado do cliente. |
| --não-verificar | Desative a verificação de certificados ao usar HTTPS, observação: essa é uma opção insegura e não deve ser usada para ambientes de produção. |
| --PEM | Caminho absoluto para o certificado do cliente, como um arquivo .pem. |
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. |
Show-Connection do cluster SFCTL
Mostrar a qual cluster do Service Fabric essa instância sfctl está conectada.
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 cluster SFCTL
Desprovisione o código ou os pacotes de configuração de um cluster do Service Fabric.
Ele é suportado para desprovisionar código e configuração separadamente.
Argumentos
| Argumento | Description |
|---|---|
| --código-versão | A versão do pacote de código do cluster. |
| --config-versão | A versão do manifesto do cluster. |
| --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 cluster SFCTL
Comece a atualizar o código ou a versão de configuração de um cluster do Service Fabric.
Valide os parâmetros de atualização fornecidos e comece a atualizar o código ou a versão de configuração de um cluster do Service Fabric se os parâmetros forem válidos.
Argumentos
| Argumento | Description |
|---|---|
| --app-health-map | Dicionário codificado JSON de pares de nome de aplicativo e porcentagem máxima não íntegra antes de gerar erro. |
| --app-type-health-map | Dicionário codificado JSON de pares de nome de tipo de aplicativo e porcentagem máxima não íntegra antes de gerar erro. |
| --código-versão | A versão do código do cluster. |
| --config-versão | A versão de configuração do cluster. |
| --delta-saúde-avaliação | Permite a avaliação de integridade delta em vez de avaliação de integridade absoluta após a conclusão de cada domínio de atualização. |
| --delta-unhealthy-nodes | A porcentagem máxima permitida de degradação da integridade dos nós permitida durante as atualizações de cluster. Padrão: 10. O delta é medido entre o estado dos nós no início da atualização e o estado dos nós no momento da avaliação de integridade. A verificação é realizada após a conclusão de cada atualização de domínio de atualização para garantir que o estado global do cluster esteja dentro dos limites tolerados. |
| --falha-ação | Os valores possíveis incluem: 'Inválido', 'Reversão', 'Manual'. |
| --forçar-reiniciar | Os processos são reiniciados com força durante a atualização, mesmo quando a versão do código não foi alterada. A atualização altera apenas a configuração ou os dados. |
| --saúde-check-retry | O período de tempo entre as tentativas de executar verificações de integridade se o aplicativo ou cluster não estiver íntegro. |
| --saúde-check-estável | 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. É 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 | 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. |
| --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. Quando esse tempo limite expirar, o processamento do domínio de atualização prosseguirá independentemente de problemas de perda de disponibilidade. O tempo limite é redefinido no início de cada domínio de atualização. Os valores válidos estão entre 0 e 42949672925 inclusive. |
| --rolling-upgrade-mode | Os valores possíveis incluem: 'Invalid', 'UnmonitoredAuto', 'UnmonitoredManual', 'Monitored'. Padrão: UnmonitoredAuto. |
| --tempo limite -t | Padrão: 60. |
| --aplicações não íntegras | A porcentagem máxima permitida de aplicativos não íntegros antes de relatar um erro. Por exemplo, para permitir que 10% dos aplicativos não estejam íntegros, esse valor seria 10. A porcentagem representa a porcentagem máxima tolerada de aplicativos que podem não estar íntegros antes que o cluster seja considerado errado. Se a percentagem for respeitada, mas houver pelo menos uma aplicação insalubre, a saúde é avaliada como Aviso. Isso é calculado dividindo o número de aplicativos não íntegros pelo número total de instâncias de aplicativo no cluster, excluindo aplicativos de tipos de aplicativo incluídos no ApplicationTypeHealthPolicyMap. O cálculo arredonda para cima para tolerar uma falha em um pequeno número de aplicações. |
| --nós insalubres | A porcentagem máxima permitida de nós não íntegros antes de relatar um erro. Por exemplo, para permitir que 10% dos nós não estejam íntegros, esse valor seria 10. A porcentagem representa a porcentagem máxima tolerada de nós que podem não estar íntegros antes que o cluster seja considerado errado. Se a porcentagem for respeitada, mas houver pelo menos um nó não íntegro, a integridade será avaliada como Aviso. A porcentagem é calculada dividindo o número de nós não íntegros sobre o número total de nós no cluster. O cálculo arredonda para cima para tolerar uma falha em pequenos números de nós. Em clusters grandes, alguns nós sempre estarão inativos ou fora para reparos, então essa porcentagem deve ser configurada para tolerar isso. |
| --upgrade-domain-delta-unhealthy-nodes | A porcentagem máxima permitida de degradação da integridade dos nós de domínio de atualização permitida durante as atualizações de cluster. Padrão: 15. O delta é medido entre o estado dos nós de domínio de atualização no início da atualização e o estado dos nós de domínio de atualização no momento da avaliação de integridade. A verificação é realizada após cada conclusão de atualização de domínio para todos os domínios de atualização concluídos para garantir que o estado dos domínios de atualização esteja dentro dos limites tolerados. |
| --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. É 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. É 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. |
Upgrade-Retomada do cluster SFCTL
Faça com que a atualização do cluster passe para o próximo domínio de atualização.
Faça com que o código do cluster ou a atualização de configuração passe para o próximo domínio de atualização, se apropriado.
Argumentos
| Argumento | Description |
|---|---|
| --upgrade-domain [Obrigatório] | O próximo domínio de atualização para esta atualização de cluster. |
| --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 cluster SFCTL
Reverter a atualização de um cluster do Service Fabric.
Reverta o código ou a atualização de configuração de um cluster do Service Fabric.
Argumentos
| Argumento | Description |
|---|---|
| --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 cluster SFCTL
Obtém o progresso da atualização de cluster atual.
Obtém o progresso atual da atualização de cluster em andamento. Se nenhuma atualização estiver atualmente em andamento, obtenha o último estado da atualização de cluster anterior.
Argumentos
| Argumento | Description |
|---|---|
| --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 de atualização do cluster SFCTL
Atualize os parâmetros de atualização de uma atualização de cluster do Service Fabric.
Argumentos
| Argumento | Description |
|---|---|
| --app-health-map | Dicionário codificado JSON de pares de nome de aplicativo e porcentagem máxima não íntegra antes de gerar erro. |
| --app-type-health-map | Dicionário codificado JSON de pares de nome de tipo de aplicativo e porcentagem máxima não íntegra antes de gerar erro. |
| --delta-saúde-avaliação | Permite a avaliação de integridade delta em vez de avaliação de integridade absoluta após a conclusão de cada domínio de atualização. |
| --delta-unhealthy-nodes | A porcentagem máxima permitida de degradação da integridade dos nós permitida durante as atualizações de cluster. Padrão: 10. O delta é medido entre o estado dos nós no início da atualização e o estado dos nós no momento da avaliação de integridade. A verificação é realizada após a conclusão de cada atualização de domínio de atualização para garantir que o estado global do cluster esteja dentro dos limites tolerados. |
| --falha-ação | Os valores possíveis incluem: 'Inválido', 'Reversão', 'Manual'. |
| --forçar-reiniciar | Os processos são reiniciados com força durante a atualização, mesmo quando a versão do código não foi alterada. A atualização altera apenas a configuração ou os dados. |
| --saúde-check-retry | O período de tempo entre as tentativas de executar verificações de integridade se o aplicativo ou cluster não estiver íntegro. |
| --saúde-check-estável | 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. É 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 | 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. |
| --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. Quando esse tempo limite expirar, o processamento do domínio de atualização prosseguirá independentemente de problemas de perda de disponibilidade. O tempo limite é redefinido no início de cada domínio de atualização. Os valores válidos estão entre 0 e 42949672925 inclusive. |
| --rolling-upgrade-mode | Os valores possíveis incluem: 'Invalid', 'UnmonitoredAuto', 'UnmonitoredManual', 'Monitored'. Padrão: UnmonitoredAuto. |
| --tempo limite -t | Padrão: 60. |
| --aplicações não íntegras | A porcentagem máxima permitida de aplicativos não íntegros antes de relatar um erro. Por exemplo, para permitir que 10% dos aplicativos não estejam íntegros, esse valor seria 10. A porcentagem representa a porcentagem máxima tolerada de aplicativos que podem não estar íntegros antes que o cluster seja considerado errado. Se a percentagem for respeitada, mas houver pelo menos uma aplicação insalubre, a saúde é avaliada como Aviso. Isso é calculado dividindo o número de aplicativos não íntegros pelo número total de instâncias de aplicativo no cluster, excluindo aplicativos de tipos de aplicativo incluídos no ApplicationTypeHealthPolicyMap. O cálculo arredonda para cima para tolerar uma falha em um pequeno número de aplicações. |
| --nós insalubres | A porcentagem máxima permitida de nós não íntegros antes de relatar um erro. Por exemplo, para permitir que 10% dos nós não estejam íntegros, esse valor seria 10. A porcentagem representa a porcentagem máxima tolerada de nós que podem não estar íntegros antes que o cluster seja considerado errado. Se a porcentagem for respeitada, mas houver pelo menos um nó não íntegro, a integridade será avaliada como Aviso. A porcentagem é calculada dividindo o número de nós não íntegros sobre o número total de nós no cluster. O cálculo arredonda para cima para tolerar uma falha em pequenos números de nós. Em clusters grandes, alguns nós sempre estarão inativos ou fora para reparos, então essa porcentagem deve ser configurada para tolerar isso. |
| --upgrade-domain-delta-unhealthy-nodes | A porcentagem máxima permitida de degradação da integridade dos nós de domínio de atualização permitida durante as atualizações de cluster. Padrão: 15. O delta é medido entre o estado dos nós de domínio de atualização no início da atualização e o estado dos nós de domínio de atualização no momento da avaliação de integridade. A verificação é realizada após cada conclusão de atualização de domínio para todos os domínios de atualização concluídos para garantir que o estado dos domínios de atualização esteja dentro dos limites tolerados. |
| --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. É 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. |
| --tipo de atualização | Os valores possíveis incluem: 'Inválido', 'Rolagem', 'Rolling_ForceRestart'. Padrão: Rolling. |
| --tempo limite de atualização | A quantidade de tempo que a atualização geral tem que ser concluída antes que FailureAction seja executado. É 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. |