sfctl service
Crie, exclua e gerencie serviços, tipos de serviços e pacotes de serviços.
Comandos
Comando | Description |
---|---|
nome do aplicativo | Obtém o nome do aplicativo Service Fabric para um serviço. |
código-pacote-lista | Obtém a lista de pacotes de código implantados em um nó do Service Fabric. |
criar | Cria o serviço Service Fabric especificado. |
delete | Exclui um serviço existente do Service Fabric. |
tipo implantado | Obtém as informações sobre um tipo de serviço especificado do aplicativo implantado em um nó em um cluster do Service Fabric. |
lista de tipos implantados | Obtém a lista que contém as informações sobre tipos de serviço dos aplicativos implantados em um nó em um cluster do Service Fabric. |
descrição | Obtém a descrição de um serviço existente do Service Fabric. |
get-container-logs | Obtém os logs de contêiner para contêiner implantado em um nó do Service Fabric. |
saúde | Obtém a integridade do serviço Service Fabric especificado. |
informação | Obtém as informações sobre o serviço específico pertencente ao aplicativo Service Fabric. |
list | Obtém as informações sobre todos os serviços pertencentes ao aplicativo especificado pela ID do aplicativo. |
manifesto | Obtém o manifesto que descreve um tipo de serviço. |
package-deploy | Downloads de pacotes associados ao manifesto de serviço especificado para o cache de imagem no nó especificado. |
Estado-Funcionamento do Pacote | Obtém as informações sobre a integridade de um pacote de serviço para um aplicativo específico implantado para um nó e aplicativo do Service Fabric. |
pacote-info | Obtém a lista de pacotes de serviço implantados em um nó do Service Fabric que corresponde exatamente ao nome especificado. |
lista de pacotes | Obtém a lista de pacotes de serviço implantados em um nó do Service Fabric. |
recuperar | Indica ao cluster do Service Fabric que ele deve tentar recuperar o serviço especificado que está atualmente preso na perda de quórum. |
relatório-saúde | Envia um relatório de integridade no serviço Service Fabric. |
resolver | Resolva uma partição do Service Fabric. |
lista de tipos | Obtém a lista que contém as informações sobre tipos de serviço suportados por um tipo de aplicativo provisionado em um cluster do Service Fabric. |
update | Atualiza o serviço especificado usando a descrição de atualização fornecida. |
Nome do aplicativo de serviço SFCTL
Obtém o nome do aplicativo Service Fabric para um serviço.
Obtém o nome do aplicativo para o serviço especificado. Um erro 404 FABRIC_E_SERVICE_DOES_NOT_EXIST é retornado se um serviço com a ID de serviço fornecida não existir.
Argumentos
Argumento | Description |
---|---|
--service-id [Obrigatório] | A identidade do serviço. Esse ID normalmente é o nome completo do serviço 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 serviço for "fabric:/myapp/app1/svc1", a identidade do serviço será "myapp~app1~svc1" em 6.0+ e "myapp/app1/svc1" 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. |
sfctl serviço code-package-list
Obtém a lista de pacotes de código implantados em um nó do Service Fabric.
Obtém a lista de pacotes de código implantados em um nó do Service Fabric para determinado 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. |
--node-name [Obrigatório] | O nome do nó. |
--código-pacote-nome | O nome do pacote de código especificado no manifesto de serviço registrado como parte de um tipo de aplicativo em um cluster do Service Fabric. |
--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. |
criação de serviço sfctl
Cria o serviço Service Fabric especificado.
Argumentos
Argumento | Description |
---|---|
--app-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. |
--name [Obrigatório] | Nome do serviço. Este deve ser um filho do ID do aplicativo. Este é o nome completo, incluindo o fabric\: URI. Por exemplo, o serviço fabric\:/A/B é filho do aplicativo fabric\:/A . |
--service-type [Obrigatório] | Nome do tipo de serviço. |
--modo de ativação | O modo de ativação para o pacote de serviço. |
--restrições | As restrições de posicionamento como uma cadeia de caracteres. As restrições de posicionamento são expressões booleanas nas propriedades do nó e permitem restringir um serviço a nós específicos com base nos requisitos do serviço. Por exemplo, para colocar um serviço em nós onde NodeType é azul, especifique o seguinte:"NodeColor == blue". |
--serviço correlacionado | Nome do serviço de destino com o qual correlacionar. |
--correlação | Correlacione o serviço com um serviço existente usando uma afinidade de alinhamento. |
--dns-nome | O nome DNS do serviço a ser criado. O serviço do sistema DNS do Service Fabric deve estar habilitado para essa configuração. |
--contagem de instâncias | A contagem de instâncias. Isto aplica-se apenas a serviços sem estado. |
--int-esquema | Indica que o serviço deve ser particionado uniformemente em um intervalo de inteiros não assinados. |
--int-esquema-contagem | O número de partições dentro do intervalo de chaves inteiras a serem criadas, se estiver usando um esquema uniforme de partição inteira. |
--int-esquema-alto | O final do intervalo de inteiros de chave, se estiver usando um esquema de partição de inteiro uniforme. |
--int-esquema-baixo | O início do intervalo de inteiros de chave, se estiver usando um esquema de partição de inteiro uniforme. |
--métricas de carga | Lista codificada JSON de métricas usadas quando serviços de balanceamento de carga entre nós. |
--min-replica-set-size | O tamanho mínimo da réplica definido como um número. Isso se aplica apenas a serviços com monitoração de estado. |
--custo de mudança | Especifica o custo de movimentação para o serviço. Os valores possíveis são: 'Zero', 'Baixo', 'Médio', 'Alto', 'VeryHigh'. |
--nomeado-esquema | Indica que o serviço deve ter várias partições nomeadas. |
--nomeado-esquema-lista | Lista codificada JSON de nomes para particionar o serviço, se estiver usando o esquema de partição nomeada. |
--nenhum estado persistente | Se verdadeiro, isso indica que o serviço não tem nenhum estado persistente armazenado no disco local ou armazena apenas o estado na memória. |
--lista de políticas de colocação | Lista codificada JSON de políticas de posicionamento para o serviço e quaisquer nomes de domínio associados. As políticas podem ser uma ou mais de: NonPartiallyPlaceService , PreferPrimaryDomain , RequireDomain , RequireDomainDistribution . |
--quorum-perda-espera | A duração máxima, em segundos, para a qual uma partição pode estar em estado de perda de quórum. Isso se aplica apenas a serviços com monitoração de estado. |
--réplica-reiniciar-esperar | A duração, em segundos, entre quando uma réplica cai e quando uma nova réplica é criada. Isso se aplica apenas a serviços com monitoração de estado. |
--políticas de escala | Lista codificada JSON de políticas de dimensionamento para este serviço. |
--serviço-colocação-tempo | A duração pela qual as réplicas podem permanecer no InBuild antes de relatar que a compilação está presa. Isso se aplica apenas a serviços com monitoração de estado. |
--regime singleton | Indica que o serviço deve ter uma única partição ou ser um serviço não particionado. |
--stand-by-réplica-manter | A duração máxima, em segundos, durante a qual as réplicas em espera serão mantidas antes de serem removidas. Isso se aplica apenas a serviços com monitoração de estado. |
--stateful | Indica que o serviço é um serviço com monitoração de estado. |
--apátrida | Indica que o serviço é um serviço sem monitoração de estado. |
--target-replica-set-size | A réplica de destino define o tamanho como um número. Isso se aplica apenas a serviços com monitoração de estado. |
--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 do serviço SFCTL
Exclui um serviço existente do Service Fabric.
Um serviço deve ser criado antes de poder ser excluído. 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 o 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 o serviço à força.
Argumentos
Argumento | Description |
---|---|
--service-id [Obrigatório] | A identidade do serviço. Esse ID normalmente é o nome completo do serviço 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 serviço for "fabric:/myapp/app1/svc1", a identidade do serviço será "myapp~app1~svc1" em 6.0+ e "myapp/app1/svc1" 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. |
Tipo implantado do serviço SFCTL
Obtém as informações sobre um tipo de serviço especificado do aplicativo implantado em um nó em um cluster do Service Fabric.
Obtém a lista que contém as informações sobre um tipo de serviço específico dos aplicativos implantados em um nó em um cluster do Service Fabric. A resposta inclui o nome do tipo de serviço, seu status de registro, o pacote de código que o registrou e a ID de ativação do pacote de serviço. Cada entrada representa uma ativação de um tipo de serviço, diferenciada pelo ID de ativaçã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. |
--node-name [Obrigatório] | O nome do nó. |
--service-type-name [Obrigatório] | Especifica o nome de um tipo de serviço do Service Fabric. |
--nome-de-manifesto-serviço | O nome do manifesto de serviço para filtrar a lista de informações de tipo de serviço implantado. Se especificado, a resposta conterá apenas as informações sobre os tipos de serviço definidos neste manifesto de serviç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. |
sfctl service deployed-type-list
Obtém a lista que contém as informações sobre tipos de serviço dos aplicativos implantados em um nó em um cluster do Service Fabric.
Obtém a lista que contém as informações sobre tipos de serviço dos aplicativos implantados em um nó em um cluster do Service Fabric. A resposta inclui o nome do tipo de serviço, seu status de registro, o pacote de código que o registrou e a ID de ativação do pacote de serviç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. |
--node-name [Obrigatório] | O nome do nó. |
--nome-de-manifesto-serviço | O nome do manifesto de serviço para filtrar a lista de informações de tipo de serviço implantado. Se especificado, a resposta conterá apenas as informações sobre os tipos de serviço definidos neste manifesto de serviç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. |
Descrição do serviço SFCTL
Obtém a descrição de um serviço existente do Service Fabric.
Obtém a descrição de um serviço existente do Service Fabric. Um serviço deve ser criado antes que sua descrição possa ser obtida.
Argumentos
Argumento | Description |
---|---|
--service-id [Obrigatório] | A identidade do serviço. Esse ID normalmente é o nome completo do serviço 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 serviço for "fabric:/myapp/app1/svc1", a identidade do serviço será "myapp~app1~svc1" em 6.0+ e "myapp/app1/svc1" 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. |
serviço sfctl get-container-logs
Obtém os logs de contêiner para contêiner implantado em um nó do Service Fabric.
Obtém os logs de contêiner para contêiner implantado em um nó do Service Fabric para o pacote de código determinado.
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. |
--code-package-name [Obrigatório] | O nome do pacote de código especificado no manifesto de serviço registrado como parte de um tipo de aplicativo em um cluster do Service Fabric. |
--node-name [Obrigatório] | O nome do nó. |
--service-manifest-name [Obrigatório] | O nome de um manifesto de serviço registrado como parte de um tipo de aplicativo em um cluster do Service Fabric. |
--anterior | Especifica se os logs de contêiner devem ser obtidos de contêineres mortos/exitados/mortos da instância do pacote de código. |
--cauda | Número de linhas a mostrar a partir do final dos logs. O padrão é 100. 'todos' para mostrar os logs completos. |
--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 serviço SFCTL
Obtém a integridade do serviço Service Fabric especificado.
Obtém as informações de integridade do serviço especificado. Use EventsHealthStateFilter para filtrar a coleção de eventos de integridade relatados no serviço com base no estado de integridade. Use PartitionsHealthStateFilter para filtrar a coleção de partições retornadas. Se você especificar um serviço que não existe no armazenamento de integridade, essa solicitação retornará um erro.
Argumentos
Argumento | Description |
---|---|
--service-id [Obrigatório] | A identidade do serviço. Esse ID normalmente é o nome completo do serviço 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 serviço for "fabric:/myapp/app1/svc1", a identidade do serviço será "myapp~app1~svc1" em 6.0+ e "myapp/app1/svc1" em versões anteriores. |
--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. |
--partitions-health-state-filter | Permite filtrar os objetos de estado de integridade das partições retornados no resultado da consulta de integridade do serviço 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 as partições que correspondem ao filtro são retornadas. Todas as partições são usadas 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 das partições 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 serviço SFCTL
Obtém as informações sobre o serviço específico pertencente ao aplicativo Service Fabric.
Retorna as informações sobre o serviço especificado pertencente ao aplicativo Service Fabric especificado.
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. |
--service-id [Obrigatório] | A identidade do serviço. Esse ID normalmente é o nome completo do serviço 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 serviço for "fabric:/myapp/app1/svc1", a identidade do serviço será "myapp~app1~svc1" em 6.0+ e "myapp/app1/svc1" 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. |
Lista de serviços SFCTL
Obtém as informações sobre todos os serviços pertencentes ao aplicativo especificado pela ID do aplicativo.
Retorna as informações sobre todos os serviços pertencentes ao aplicativo especificado pela ID 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. |
--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. |
--nome-tipo-serviço | O nome do tipo de serviço usado para filtrar os serviços a serem consultados. |
--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 de serviço sfctl
Obtém o manifesto que descreve um tipo de serviço.
Obtém o manifesto que descreve um tipo de serviço. A resposta contém o XML do manifesto de serviço 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. |
--service-manifest-name [Obrigatório] | 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. |
sfctl service package-deploy
Downloads de pacotes associados ao manifesto de serviço especificado para o cache de imagem no nó especificado.
Argumentos
Argumento | Description |
---|---|
--app-type-name [Obrigatório] | O nome do manifesto do aplicativo para o manifesto de serviço solicitado correspondente. |
--app-type-version [Obrigatório] | A versão do manifesto do aplicativo para o manifesto de serviço solicitado correspondente. |
--node-name [Obrigatório] | O nome do nó. |
--service-manifest-name [Obrigatório] | O nome do manifesto de serviço associado aos pacotes que serão baixados. |
--política de ações | Lista codificada JSON de políticas de compartilhamento. Cada elemento da política de partilha é composto por um «nome» e um «âmbito». O nome corresponde ao nome do código, configuração ou pacote de dados a ser compartilhado. O escopo pode ser 'Nenhum', 'Todos', 'Código', 'Configuração' ou 'Dados'. |
--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. |
Integridade do pacote de serviços SFCTL
Obtém as informações sobre a integridade de um pacote de serviço para um aplicativo específico implantado para um nó e aplicativo do Service Fabric.
Obtém as informações sobre a integridade de um pacote de serviço para um aplicativo específico implantado em um nó do Service Fabric. Use EventsHealthStateFilter para, opcionalmente, filtrar a coleção de objetos HealthEvent relatados no pacote de serviço implantado 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ó. |
--service-package-name [Obrigatório] | O nome do pacote de serviço. |
--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. |
sfctl service package-info
Obtém a lista de pacotes de serviço implantados em um nó do Service Fabric que corresponde exatamente ao nome especificado.
Retorna as informações sobre os pacotes de serviço implantados em um nó do Service Fabric para determinado aplicativo. Esses resultados são de pacotes de serviço cujo nome corresponde exatamente ao nome do pacote de serviço especificado como parâmetro.
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ó. |
--service-package-name [Obrigatório] | O nome do pacote de serviç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. |
Lista de pacotes de serviços SFCTL
Obtém a lista de pacotes de serviço implantados em um nó do Service Fabric.
Retorna as informações sobre os pacotes de serviço implantados em um nó do Service Fabric para determinado 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. |
--node-name [Obrigatório] | O nome do nó. |
--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. |
Recuperação de serviço SFCTL
Indica ao cluster do Service Fabric que ele deve tentar recuperar o serviço especificado que está atualmente preso na perda de quórum.
Indica ao cluster do Service Fabric que ele deve tentar recuperar o serviço especificado que está atualmente preso 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 |
---|---|
--service-id [Obrigatório] | A identidade do serviço. Esse ID normalmente é o nome completo do serviço 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 serviço for "fabric:/myapp/app1/svc1", a identidade do serviço será "myapp~app1~svc1" em 6.0+ e "myapp/app1/svc1" 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. |
Relatório de integridade do serviço SFCTL
Envia um relatório de integridade no serviço Service Fabric.
Relata o estado de integridade do serviço 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 serviço 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, verifique se o relatório aparece nos eventos de integridade do serviço.
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'. |
--service-id [Obrigatório] | A identidade do serviço. Normalmente, este é o nome completo do serviço 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 serviço for 'fabric:/myapp/app1/svc1', a identidade do serviço será 'myapp~app1~svc1' em 6.0+ e 'myapp/app1/svc1' em versões anteriores. |
--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. |
Resolução de serviço SFCTL
Resolva uma partição do Service Fabric.
Resolva uma partição de serviço do Service Fabric para obter os pontos de extremidade das réplicas de serviço.
Argumentos
Argumento | Description |
---|---|
--service-id [Obrigatório] | A identidade do serviço. Esse ID normalmente é o nome completo do serviço 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 serviço for "fabric:/myapp/app1/svc1", a identidade do serviço será "myapp~app1~svc1" em 6.0+ e "myapp/app1/svc1" em versões anteriores. |
--partition-key-type | Tipo de chave para a partição. Este parâmetro é necessário se o esquema de partição para o serviço é Int64Range ou Named. Os valores possíveis estão a seguir. - Nenhum (1) - Indica que o parâmetro PartitionKeyValue não está especificado. Isso é válido para as partições com esquema de particionamento como Singleton. Este é o valor predefinido. O valor é 1. - Int64Range (2) - Indica que o parâmetro PartitionKeyValue é uma chave de partição int64. Isso é válido para as partições com esquema de particionamento como Int64Range. O valor é 2. - Nomeado (3) - Indica que o parâmetro PartitionKeyValue é um nome da partição. Isso é válido para as partições com esquema de particionamento como Named. O valor é 3. |
--partição-chave-valor | Chave de partição. Isso é necessário se o esquema de partição para o serviço for Int64Range ou Named. Este não é o ID da partição, mas sim o valor da chave inteira ou o nome do ID da partição. Por exemplo, se o seu serviço estiver usando partições variadas de 0 a 10, elas PartitionKeyValue seriam um inteiro nesse intervalo. Consulte a descrição do serviço para ver o intervalo ou o nome. |
--anterior-rsp-versão | O valor no campo Versão da resposta recebida anteriormente. Isso é necessário se o usuário souber que o resultado obtido anteriormente é obsoleto. |
--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 serviço SFCTL
Obtém a lista que contém as informações sobre tipos de serviço suportados por um tipo de aplicativo provisionado em um cluster do Service Fabric.
Obtém a lista que contém as informações sobre tipos de serviço suportados por um tipo de aplicativo provisionado em um cluster do Service Fabric. O tipo de aplicativo fornecido deve existir. Caso contrário, um status 404 será retornado.
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. |
Atualização do serviço SFCTL
Atualiza o serviço especificado usando a descrição de atualização fornecida.
Argumentos
Argumento | Description |
---|---|
--service-id [Obrigatório] | A identidade do serviço. Normalmente, este é o nome completo do serviço 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 serviço for 'fabric:/myapp/app1/svc1', a identidade do serviço será 'myapp~app1~svc1' em 6.0+ e 'myapp/app1/svc1' em versões anteriores. |
--restrições | As restrições de posicionamento como uma cadeia de caracteres. As restrições de posicionamento são expressões booleanas nas propriedades do nó e permitem restringir um serviço a nós específicos com base nos requisitos do serviço. Por exemplo, para colocar um serviço em nós onde NodeType é azul, especifique o seguinte: "NodeColor == blue". |
--serviço correlacionado | Nome do serviço de destino com o qual correlacionar. |
--correlação | Correlacione o serviço com um serviço existente usando uma afinidade de alinhamento. |
--contagem de instâncias | A contagem de instâncias. Isto aplica-se apenas a serviços sem estado. |
--métricas de carga | Lista codificada JSON de métricas usadas durante o balanceamento de carga entre nós. |
--min-replica-set-size | O tamanho mínimo da réplica definido como um número. Isso se aplica apenas a serviços com monitoração de estado. |
--custo de mudança | Especifica o custo de movimentação para o serviço. Os valores possíveis são: 'Zero', 'Baixo', 'Médio', 'Alto', 'VeryHigh'. |
--lista de políticas de colocação | Lista codificada JSON de políticas de posicionamento para o serviço e quaisquer nomes de domínio associados. As políticas podem ser uma ou mais de: NonPartiallyPlaceService , PreferPrimaryDomain , RequireDomain , RequireDomainDistribution . |
--quorum-perda-espera | A duração máxima, em segundos, para a qual uma partição pode estar em estado de perda de quórum. Isso se aplica apenas a serviços com monitoração de estado. |
--réplica-reiniciar-esperar | A duração, em segundos, entre quando uma réplica cai e quando uma nova réplica é criada. Isso se aplica apenas a serviços com monitoração de estado. |
--políticas de escala | Lista codificada JSON de políticas de dimensionamento para este serviço. |
--serviço-colocação-tempo | A duração pela qual as réplicas podem permanecer no InBuild antes de relatar que a compilação está presa. Isso se aplica apenas a serviços com monitoração de estado. |
--stand-by-réplica-manter | A duração máxima, em segundos, durante a qual as réplicas em espera serão mantidas antes de serem removidas. Isso se aplica apenas a serviços com monitoração de estado. |
--stateful | Indica que o serviço de destino é um serviço com monitoração de estado. |
--apátrida | Indica que o serviço de destino é um serviço sem monitoração de estado. |
--target-replica-set-size | A réplica de destino define o tamanho como um número. Isso se aplica apenas a serviços com monitoração de estado. |
--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. |
Próximos passos
- Configure a CLI do Service Fabric.
- Saiba como usar a CLI do Service Fabric usando os scripts de exemplo.