sfctl replica
Gerencie as réplicas que pertencem a partições de serviço.
Comandos
| Comando | Description |
|---|---|
| implantado | Obtém os detalhes da réplica implantada em um nó do Service Fabric. |
| lista implantada | Obtém a lista de réplicas implantadas em um nó do Service Fabric. |
| saúde | Obtém a integridade de uma réplica de serviço stateful do Service Fabric ou instância de serviço stateless. |
| informação | Obtém as informações sobre uma réplica de uma partição do Service Fabric. |
| list | Obtém as informações sobre réplicas de uma partição de serviço do Service Fabric. |
| remove | Remove uma réplica de serviço em execução em um nó. |
| relatório-saúde | Envia um relatório de integridade na réplica do Service Fabric. |
| restart | Reinicia uma réplica de serviço de um serviço persistente em execução em um nó. |
Réplica SFCTL implantada
Obtém os detalhes da réplica implantada em um nó do Service Fabric.
Obtém os detalhes da réplica implantada em um nó do Service Fabric. As informações incluem tipo de serviço, nome do serviço, operação de serviço atual, hora da data de início da operação de serviço atual, ID da partição, ID da réplica/instância, carga relatada e outras informações.
Argumentos
| Argumento | Description |
|---|---|
| --node-name [Obrigatório] | O nome do nó. |
| --partition-id [Obrigatório] | A identidade da partição. |
| --replica-id [Obrigatório] | O identificador da réplica. |
| --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 de réplica SFCTL
Obtém a lista de réplicas implantadas em um nó do Service Fabric.
Obtém a lista que contém as informações sobre réplicas implantadas em um nó do Service Fabric. As informações incluem ID da partição, ID da réplica, status da réplica, nome do serviço, nome do tipo de serviço e outras informações. Use os parâmetros de consulta PartitionId ou ServiceManifestName para retornar informações sobre as réplicas implantadas que correspondem aos valores especificados para esses parâmetros.
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ó. |
| --ID da partição | A identidade da partição. |
| --nome-de-manifesto-serviço | O nome de um manifesto de serviço registrado como parte de um tipo de aplicativo em um cluster 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 da réplica SFCTL
Obtém a integridade de uma réplica de serviço stateful do Service Fabric ou instância de serviço stateless.
Obtém a integridade de uma réplica do Service Fabric. Use EventsHealthStateFilter para filtrar a coleção de eventos de integridade relatados na réplica com base no estado de integridade.
Argumentos
| Argumento | Description |
|---|---|
| --partition-id [Obrigatório] | A identidade da partição. |
| --replica-id [Obrigatório] | O identificador da réplica. |
| --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. |
| --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 da réplica sfctl
Obtém as informações sobre uma réplica de uma partição do Service Fabric.
A resposta inclui a ID, função, status, integridade, nome do nó, tempo de atividade e outros detalhes sobre a réplica.
Argumentos
| Argumento | Description |
|---|---|
| --partition-id [Obrigatório] | A identidade da partição. |
| --replica-id [Obrigatório] | O identificador da réplica. |
| --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 réplicas SFCTL
Obtém as informações sobre réplicas de uma partição de serviço do Service Fabric.
O ponto de extremidade GetReplicas retorna informações sobre as réplicas da partição especificada. A resposta inclui a ID, função, status, integridade, nome do nó, tempo de atividade e outros detalhes sobre a réplica.
Argumentos
| Argumento | Description |
|---|---|
| --partition-id [Obrigatório] | A identidade da partição. |
| --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. |
| --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. |
Remover réplica sfctl
Remove uma réplica de serviço em execução em um nó.
Essa API simula uma falha de réplica do Service Fabric removendo uma réplica de um cluster do Service Fabric. A remoção fecha a réplica, faz a transição da réplica para a função None e, em seguida, remove todas as informações de estado da réplica do cluster. Essa API testa o caminho de remoção do estado da réplica e simula o caminho permanente de falha do relatório por meio de APIs de cliente. Aviso - Não há verificações de segurança realizadas quando esta API é usada. O uso incorreto dessa API pode levar à perda de dados para serviços com monitoração de estado. Além disso, o sinalizador forceRemove afeta todas as outras réplicas hospedadas no mesmo processo.
Argumentos
| Argumento | Description |
|---|---|
| --node-name [Obrigatório] | O nome do nó. |
| --partition-id [Obrigatório] | A identidade da partição. |
| --replica-id [Obrigatório] | O identificador da réplica. |
| --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. |
Integridade do relatório de réplica SFCTL
Envia um relatório de integridade na réplica do Service Fabric.
Relata o estado de integridade da réplica do Service Fabric especificada. 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 uma réplica 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 get replica health 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'. |
| --partition-id [Obrigatório] | A identidade da partição. |
| --replica-id [Obrigatório] | A identidade da partição. |
| --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. |
| --tipo de serviço | O tipo de réplica de serviço (stateless ou stateful) para o qual a integridade está sendo relatada. Seguem-se os valores possíveis: «Apátrida», «Apátrida». Padrão: Stateful. |
| --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. |
reinicialização da réplica sfctl
Reinicia uma réplica de serviço de um serviço persistente em execução em um nó.
Reinicia uma réplica de serviço de um serviço persistente em execução em um nó. Aviso - Não há verificações de segurança realizadas quando esta API é usada. O uso incorreto dessa API pode levar à perda de disponibilidade para serviços com monitoração de estado.
Argumentos
| Argumento | Description |
|---|---|
| --node-name [Obrigatório] | O nome do nó. |
| --partition-id [Obrigatório] | A identidade da partição. |
| --replica-id [Obrigatório] | O identificador da réplica. |
| --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. |