sfctl application

Criar, eliminar e gerir aplicações e tipos de aplicações.

Comandos

Comando Descrição
create Cria uma aplicação do Service Fabric com a descrição especificada.
delete Elimina uma aplicação do Service Fabric existente.
implementado Obtém as informações sobre uma aplicação implementada num nó do Service Fabric.
deployed-health Obtém as informações sobre o estado de funcionamento de uma aplicação implementada num nó do Service Fabric.
deployed-list Obtém a lista de aplicações implementadas num nó do Service Fabric.
estado de funcionamento Obtém o estado de funcionamento da aplicação do service fabric.
informações Obtém informações sobre uma aplicação do Service Fabric.
list Obtém a lista de aplicações criadas no cluster do Service Fabric que correspondem aos filtros especificados.
carregar Obtém informações de carregamento sobre uma aplicação do Service Fabric.
manifest Obtém o manifesto que descreve um tipo de aplicação.
aprovisionamento Aprovisiona ou regista um tipo de aplicação do Service Fabric com o cluster com o pacote ".sfpkg" no arquivo externo ou com o pacote de aplicação no arquivo de imagens.
report-health Envia um relatório de estado de funcionamento na aplicação do Service Fabric.
tipo Obtém a lista de tipos de aplicações no cluster do Service Fabric que correspondem exatamente ao nome especificado.
type-list Obtém a lista de tipos de aplicações no cluster do Service Fabric.
não aprovoamento Remove ou anule o registo de um tipo de aplicação do Service Fabric do cluster.
atualizar Começa a atualizar uma aplicação no cluster do Service Fabric.
upgrade-resume Retoma a atualização de uma aplicação no cluster do Service Fabric.
upgrade-rollback Começa a reverter a atualização atualmente em curso de uma aplicação no cluster do Service Fabric.
estado da atualização Obtém detalhes sobre a atualização mais recente efetuada nesta aplicação.
carregar Copie um pacote de aplicação do Service Fabric para o arquivo de imagens.

sfctl application create

Cria uma aplicação do Service Fabric com a descrição especificada.

Argumentos

Argumento Description
--app-name [Obrigatório] O nome da aplicação, incluindo o esquema URI "fabric:".
--app-type [Obrigatório] O nome do tipo de aplicação encontrado no manifesto da aplicação.
--app-version [Necessário] A versão do tipo de aplicação, conforme definido no manifesto da aplicação.
--max-node-count O número máximo de nós em que o Service Fabric reserva capacidade para esta aplicação. Tenha em atenção que isto não significa que os serviços desta aplicação serão colocados em todos esses nós.
--metrics Uma lista codificada JSON de descrições de métricas de capacidade da aplicação. Uma métrica é definida como um nome, associado a um conjunto de capacidades para cada nó em que a aplicação existe.
--min-node-count O número mínimo de nós em que o Service Fabric reserva capacidade para esta aplicação. Tenha em atenção que isto não significa que os serviços desta aplicação serão colocados em todos esses nós.
--parâmetros Uma lista codificada JSON de substituições de parâmetros de aplicação a aplicar ao criar a aplicação.
--timeout -t Predefinição: 60.

Argumentos Globais

Argumento Description
--depurar Aumente a verbosidade do registo para mostrar todos os registos de depuração.
--help -h Mostrar esta mensagem de ajuda e sair.
--output -o Formato de saída. Valores permitidos: json, jsonc, table, tsv. Predefinição: json.
--consulta Cadeia de consulta JMESPath. Veja http://jmespath.org/ para obter mais informações e exemplos.
--verboso Aumente a verbosidade do registo. Utilize --debug para registos de depuração completos.

sfctl application delete

Elimina uma aplicação do Service Fabric existente.

Uma aplicação tem de ser criada antes de poder ser eliminada. Eliminar uma aplicação eliminará todos os serviços que fazem parte dessa aplicação. Por predefinição, o Service Fabric tentará fechar as réplicas de serviço de forma correta e, em seguida, eliminará o serviço. No entanto, se um serviço estiver a ter problemas ao fechar a réplica corretamente, a operação de eliminação pode demorar muito tempo ou ficar bloqueada. Utilize o sinalizador ForceRemove opcional para ignorar a sequência de fecho correta e eliminar com força a aplicação e todos os seus serviços.

Argumentos

Argumento Description
--application-id [Necessário] A identidade da aplicação. Normalmente, este é o nome completo da aplicação sem o esquema de URI "fabric:". A partir da versão 6.0, os nomes hierárquicos são delimitados com o caráter "~". Por exemplo, se o nome da aplicação for "fabric:/myapp/app1", a identidade da aplicação será "myapp~app1" em 6.0+ e "myapp/app1" em versões anteriores.
--force-remove Remova uma aplicação ou serviço do Service Fabric com força sem passar pela sequência de encerramento correta. Este parâmetro pode ser utilizado para eliminar com força uma aplicação ou serviço para o qual a eliminação está a exceder o tempo limite devido a problemas no código de serviço que impedem o encerramento correto das réplicas.
--timeout -t O tempo limite do servidor para executar a operação em segundos. Este tempo limite especifica a duração de tempo que o cliente está disposto a aguardar pela conclusão da operação pedida. O valor predefinido para este parâmetro é 60 segundos. Predefinição: 60.

Argumentos Globais

Argumento Description
--depurar Aumente a verbosidade do registo para mostrar todos os registos de depuração.
--help -h Mostrar esta mensagem de ajuda e sair.
--output -o Formato de saída. Valores permitidos: json, jsonc, table, tsv. Predefinição: json.
--consulta Cadeia de consulta JMESPath. Veja http://jmespath.org/ para obter mais informações e exemplos.
--verboso Aumente a verbosidade do registo. Utilize --debug para registos de depuração completos.

aplicação sfctl implementada

Obtém as informações sobre uma aplicação implementada num nó do Service Fabric.

Esta consulta devolve informações da aplicação do sistema se o ID da aplicação fornecido for para a aplicação de sistema. Os resultados abrangem aplicações implementadas em estados ativos, de ativação e de transferência. Esta consulta requer que o nome do nó corresponda a um nó no cluster. A consulta falha se o nome do nó fornecido não apontar para nós ativos do Service Fabric no cluster.

Argumentos

Argumento Description
--application-id [Necessário] A identidade da aplicação. Normalmente, este é o nome completo da aplicação sem o esquema de URI "fabric:". A partir da versão 6.0, os nomes hierárquicos são delimitados com o caráter "~". Por exemplo, se o nome da aplicação for "fabric:/myapp/app1", a identidade da aplicação será "myapp~app1" em 6.0+ e "myapp/app1" em versões anteriores.
--node-name [Obrigatório] O nome do nó.
--include-health-state Inclua o estado de funcionamento de uma entidade. Se este parâmetro for falso ou não for especificado, o estado de funcionamento devolvido é "Desconhecido". Quando definida como verdadeira, a consulta fica paralela ao nó e ao serviço do sistema de estado de funcionamento antes de os resultados serem intercalados. Como resultado, a consulta é mais cara e pode demorar mais tempo.
--timeout -t O tempo limite do servidor para executar a operação em segundos. Este tempo limite especifica a duração de tempo que o cliente está disposto a aguardar pela conclusão da operação pedida. O valor predefinido para este parâmetro é 60 segundos. Predefinição: 60.

Argumentos Globais

Argumento Description
--depurar Aumente a verbosidade do registo para mostrar todos os registos de depuração.
--help -h Mostrar esta mensagem de ajuda e sair.
--output -o Formato de saída. Valores permitidos: json, jsonc, table, tsv. Predefinição: json.
--consulta Cadeia de consulta JMESPath. Veja http://jmespath.org/ para obter mais informações e exemplos.
--verboso Aumente a verbosidade do registo. Utilize --debug para registos de depuração completos.

sfctl application deployed-health

Obtém as informações sobre o estado de funcionamento de uma aplicação implementada num nó do Service Fabric.

Obtém as informações sobre o estado de funcionamento de uma aplicação implementada num nó do Service Fabric. Utilize EventsHealthStateFilter para filtrar opcionalmente a coleção de objetos HealthEvent comunicados na aplicação implementada com base no estado de funcionamento. Utilize DeployedServicePackagesHealthStateFilter para filtrar opcionalmente as crianças DeployedServicePackageHealth com base no estado de funcionamento.

Argumentos

Argumento Description
--application-id [Necessário] A identidade da aplicação. Normalmente, este é o nome completo da aplicação sem o esquema de URI "fabric:". A partir da versão 6.0, os nomes hierárquicos são delimitados com o caráter "~". Por exemplo, se o nome da aplicação for "fabric:/myapp/app1", a identidade da aplicação será "myapp~app1" em 6.0+ e "myapp/app1" em versões anteriores.
--node-name [Obrigatório] O nome do nó.
--deployed-service-packages-health-state-filter Permite a filtragem dos objetos de estado de funcionamento do pacote de serviço implementados devolvidos no resultado da consulta de estado de funcionamento da aplicação implementada com base no respetivo estado de funcionamento. Os valores possíveis para este parâmetro incluem o valor inteiro de um dos seguintes estados de estado de funcionamento. Só são devolvidos pacotes de serviço implementados que correspondam ao filtro. Todos os pacotes de serviço implementados são utilizados para avaliar o estado de funcionamento agregado da aplicação implementada. Se não for especificado, todas as entradas são devolvidas. Os valores de estado são enumeração baseada em sinalizador, pelo que o valor pode ser uma combinação destes valores, obtida com o operador "OR" bit-a-bit. Por exemplo, se o valor fornecido for 6, será devolvido o estado de funcionamento dos pacotes de serviço com o valor HealthState de OK (2) e Aviso (4).
- Predefinição - Valor predefinido. Corresponde a qualquer Estado de Funcionamento. O valor é zero.
- Nenhum - Filtro que não corresponde a nenhum valor HealthState. Utilizado para não devolver resultados numa determinada coleção de estados. O valor é 1.
- Ok - Filtrar que corresponde à entrada com o valor HealthState Ok. O valor é 2.
- Aviso – filtro que corresponde à entrada com o valor HealthState Aviso. O valor é 4.
- Erro – filtro que corresponde à entrada com o valor HealthState Erro. O valor é 8.
- Tudo - Filtrar que corresponde à entrada com qualquer valor HealthState. O valor é 65535.
--events-health-state-filter Permite filtrar a coleção de objetos HealthEvent devolvidos com base no estado de funcionamento. Os valores possíveis para este parâmetro incluem o valor inteiro de um dos seguintes estados de estado de funcionamento. Só são devolvidos eventos que correspondam ao filtro. Todos os eventos são utilizados para avaliar o estado de funcionamento agregado. Se não for especificado, todas as entradas são devolvidas. Os valores de estado são enumeração baseada em sinalizador, pelo que o valor pode ser uma combinação destes valores, obtida com o operador "OR" bit-a-bit. Por exemplo, se o valor fornecido for 6, todos os eventos com o valor HealthState de OK (2) e Aviso (4) são devolvidos.
- Predefinição - Valor predefinido. Corresponde a qualquer Estado de Funcionamento. O valor é zero.
- Nenhum - Filtro que não corresponde a nenhum valor HealthState. Utilizado para não devolver resultados numa determinada coleção de estados. O valor é 1.
- Ok - Filtrar que corresponde à entrada com o valor HealthState Ok. O valor é 2.
- Aviso – filtro que corresponde à entrada com o valor HealthState Aviso. O valor é 4.
- Erro – filtro que corresponde à entrada com o valor HealthState Erro. O valor é 8.
- Tudo - Filtrar que corresponde à entrada com qualquer valor HealthState. O valor é 65535.
--exclude-health-statistics Indica se as estatísticas de estado de funcionamento devem ser devolvidas como parte do resultado da consulta. Falso por predefinição. As estatísticas mostram o número de entidades subordinadas no estado de funcionamento Ok, Aviso e Erro.
--timeout -t O tempo limite do servidor para executar a operação em segundos. Este tempo limite especifica a duração de tempo que o cliente está disposto a aguardar pela conclusão da operação pedida. O valor predefinido para este parâmetro é 60 segundos. Predefinição: 60.

Argumentos Globais

Argumento Description
--depurar Aumente a verbosidade do registo para mostrar todos os registos de depuração.
--help -h Mostrar esta mensagem de ajuda e sair.
--output -o Formato de saída. Valores permitidos: json, jsonc, table, tsv. Predefinição: json.
--consulta Cadeia de consulta JMESPath. Veja http://jmespath.org/ para obter mais informações e exemplos.
--verboso Aumente a verbosidade do registo. Utilize --debug para registos de depuração completos.

sfctl application deployed-list

Obtém a lista de aplicações implementadas num nó do Service Fabric.

Obtém a lista de aplicações implementadas num nó do Service Fabric. Os resultados não incluem informações sobre aplicações de sistema implementadas, a menos que sejam consultadas explicitamente por ID. Os resultados abrangem aplicações implementadas em estados ativos, de ativação e de transferência. Esta consulta requer que o nome do nó corresponda a um nó no cluster. A consulta falha se o nome do nó fornecido não apontar para nós ativos do Service Fabric no cluster.

Argumentos

Argumento Description
--node-name [Obrigatório] O nome do nó.
--continuation-token O parâmetro do token de continuação é utilizado 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 numa única resposta. Quando este valor é transmitido para a próxima chamada à API, a API devolve o próximo conjunto de resultados. Se não existirem mais resultados, o token de continuação não contém um valor. O valor deste parâmetro não deve ser codificado por URL.
--include-health-state Inclua o estado de funcionamento de uma entidade. Se este parâmetro for falso ou não for especificado, o estado de funcionamento devolvido é "Desconhecido". Quando definida como verdadeira, a consulta fica paralela ao nó e ao serviço do sistema de estado de funcionamento antes de os resultados serem intercalados. Como resultado, a consulta é mais cara e pode demorar mais tempo.
--max-results O número máximo de resultados a devolver como parte das consultas paginadas. Este parâmetro define o limite superior no número de resultados devolvidos. Os resultados devolvidos podem ser inferiores aos resultados máximos especificados se não se ajustarem à mensagem de acordo com as restrições de tamanho máximo da mensagem definidas na configuração. Se este parâmetro for zero ou não for especificado, a consulta paginada inclui o maior número possível de resultados que se enquadram na mensagem de retorno.
--timeout -t O tempo limite do servidor para executar a operação em segundos. Este tempo limite especifica a duração de tempo que o cliente está disposto a aguardar pela conclusão da operação pedida. O valor predefinido para este parâmetro é 60 segundos. Predefinição: 60.

Argumentos Globais

Argumento Description
--depurar Aumente a verbosidade do registo para mostrar todos os registos de depuração.
--help -h Mostrar esta mensagem de ajuda e sair.
--output -o Formato de saída. Valores permitidos: json, jsonc, table, tsv. Predefinição: json.
--query Cadeia de consulta JMESPath. Veja http://jmespath.org/ para obter mais informações e exemplos.
--verboso Aumentar a verbosidade do registo. Utilize --debug para registos de depuração completos.

estado de funcionamento da aplicação sfctl

Obtém o estado de funcionamento da aplicação do service fabric.

Devolve o estado de funcionamento da aplicação do service fabric. A resposta comunica o estado de funcionamento Ok, Erro ou Aviso. Se a entidade não for encontrada no arquivo de estado de funcionamento, devolverá o Erro.

Argumentos

Argumento Description
--application-id [Necessário] A identidade da aplicação. Normalmente, este é o nome completo da aplicação sem o esquema de URI "fabric:". A partir da versão 6.0, os nomes hierárquicos são delimitados com o caráter "~". Por exemplo, se o nome da aplicação for "fabric:/myapp/app1", a identidade da aplicação será "myapp~app1" na versão 6.0+ e "myapp/app1" em versões anteriores.
--deployed-applications-health-state-filter Permite a filtragem dos objetos de estado de funcionamento das aplicações implementadas devolvidos no resultado da consulta do estado de funcionamento da aplicação com base no respetivo estado de funcionamento. Os valores possíveis para este parâmetro incluem o valor inteiro de um dos seguintes estados de funcionamento. Só serão devolvidas as aplicações implementadas que correspondam ao filtro. Todas as aplicações implementadas são utilizadas para avaliar o estado de funcionamento agregado. Se não for especificado, todas as entradas são devolvidas. Os valores de estado são uma enumeração baseada em sinalizadores, pelo que o valor pode ser uma combinação destes valores, obtida com o operador bit-a-bit "OR". Por exemplo, se o valor fornecido for 6, será devolvido o estado de funcionamento das aplicações implementadas com o valor HealthState de OK (2) e Aviso (4).
- Predefinição - Valor predefinido. Corresponde a qualquer HealthState. O valor é zero.
- Nenhum - Filtro que não corresponde a qualquer valor HealthState. Utilizado para não devolver resultados numa 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 Aviso. O valor é 4.
- Erro - Filtro que corresponde à entrada com o valor HealthState Erro. O valor é 8.
- Todos - Filtro que corresponde à entrada com qualquer valor HealthState. O valor é 65535.
--events-health-state-filter Permite filtrar a coleção de objetos HealthEvent devolvidos com base no estado de funcionamento. Os valores possíveis para este parâmetro incluem o valor inteiro de um dos seguintes estados de funcionamento. Só são devolvidos eventos que correspondam ao filtro. Todos os eventos são utilizados para avaliar o estado de funcionamento agregado. Se não for especificado, todas as entradas são devolvidas. Os valores de estado são uma enumeração baseada em sinalizadores, pelo que o valor pode ser uma combinação destes valores, obtida com 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 Aviso (4) são devolvidos.
- Predefinição - Valor predefinido. Corresponde a qualquer HealthState. O valor é zero.
- Nenhum - Filtro que não corresponde a qualquer valor HealthState. Utilizado para não devolver resultados numa 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 Aviso. O valor é 4.
- Erro - Filtro que corresponde à entrada com o valor HealthState Erro. O valor é 8.
- Todos - Filtro que corresponde à entrada com qualquer valor HealthState. O valor é 65535.
--exclude-health-statistics Indica se as estatísticas de estado de funcionamento devem ser devolvidas como parte do resultado da consulta. Falso por predefinição. As estatísticas mostram o número de entidades subordinadas no estado de funcionamento OK, Aviso e Erro.
--services-health-state-filter Permite a filtragem dos objetos de estado de funcionamento dos serviços devolvidos no resultado da consulta de estado de funcionamento dos serviços com base no estado de funcionamento. Os valores possíveis para este parâmetro incluem o valor inteiro de um dos seguintes estados de funcionamento. Apenas os serviços que correspondem ao filtro são devolvidos. Todos os serviços são utilizados para avaliar o estado de funcionamento agregado. Se não for especificado, todas as entradas são devolvidas. Os valores de estado são uma enumeração baseada em sinalizadores, pelo que o valor pode ser uma combinação destes valores, obtida com o operador bit-a-bit "OR". Por exemplo, se o valor fornecido for 6, será devolvido o estado de funcionamento dos serviços com o valor HealthState de OK (2) e Aviso (4).
- Predefinição - Valor predefinido. Corresponde a qualquer HealthState. O valor é zero.
- Nenhum - Filtro que não corresponde a qualquer valor HealthState. Utilizado para não devolver resultados numa 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 Aviso. O valor é 4.
- Erro - Filtro que corresponde à entrada com o valor HealthState Erro. O valor é 8.
- Todos - Filtro que corresponde à entrada com qualquer valor HealthState. O valor é 65535.
--timeout -t O tempo limite do servidor para executar a operação em segundos. Este tempo limite especifica a duração de tempo que o cliente está disposto a aguardar que a operação pedida seja concluída. O valor predefinido para este parâmetro é 60 segundos. Predefinição: 60.

Argumentos Globais

Argumento Description
--debug Aumente a verbosidade do registo para mostrar todos os registos de depuração.
--help -h Mostrar esta mensagem de ajuda e sair.
--output -o Formato de saída. Valores permitidos: json, jsonc, table, tsv. Predefinição: json.
--consulta Cadeia de consulta JMESPath. Veja http://jmespath.org/ para obter mais informações e exemplos.
--verboso Aumente a verbosidade do registo. Utilize --debug para registos de depuração completos.

informações da aplicação sfctl

Obtém informações sobre uma aplicação do Service Fabric.

Devolve as informações sobre a aplicação que foi criada ou no processo de criação no cluster do Service Fabric e cujo nome corresponde ao especificado como o parâmetro. A resposta inclui o nome, o tipo, o estado, os parâmetros e outros detalhes sobre a aplicação.

Argumentos

Argumento Description
--application-id [Necessário] A identidade da aplicação. Normalmente, este é o nome completo da aplicação sem o esquema de URI "fabric:". A partir da versão 6.0, os nomes hierárquicos são delimitados com o caráter "~". Por exemplo, se o nome da aplicação for "fabric:/myapp/app1", a identidade da aplicação será "myapp~app1" em 6.0+ e "myapp/app1" em versões anteriores.
--exclude-application-parameters O sinalizador que especifica se os parâmetros da aplicação serão excluídos do resultado.
--timeout -t O tempo limite do servidor para executar a operação em segundos. Este tempo limite especifica a duração de tempo que o cliente está disposto a aguardar pela conclusão da operação pedida. O valor predefinido para este parâmetro é 60 segundos. Predefinição: 60.

Argumentos Globais

Argumento Description
--depurar Aumente a verbosidade do registo para mostrar todos os registos de depuração.
--help -h Mostrar esta mensagem de ajuda e sair.
--output -o Formato de saída. Valores permitidos: json, jsonc, table, tsv. Predefinição: json.
--consulta Cadeia de consulta JMESPath. Veja http://jmespath.org/ para obter mais informações e exemplos.
--verboso Aumente a verbosidade do registo. Utilize --debug para registos de depuração completos.

lista de aplicações sfctl

Obtém a lista de aplicações criadas no cluster do Service Fabric que correspondem aos filtros especificados.

Obtém as informações sobre as aplicações que foram criadas ou no processo de criação no cluster do Service Fabric e correspondem aos filtros especificados. A resposta inclui o nome, o tipo, o estado, os parâmetros e outros detalhes sobre a aplicação. Se as aplicações não caberem numa página, é devolvida uma página de resultados, bem como um token de continuação, que pode ser utilizado para obter a página seguinte. Os filtros ApplicationTypeName e ApplicationDefinitionKindFilter não podem ser especificados ao mesmo tempo.

Argumentos

Argumento Description
--application-definition-kind-filter Utilizado para filtrar em ApplicationDefinitionKind, que é o mecanismo utilizado para definir uma aplicação do Service Fabric.
- Predefinição – valor predefinido, que executa a mesma função que selecionar "Todos". O valor é 0.
- Tudo - Filtrar que corresponde à entrada com qualquer valor ApplicationDefinitionKind. O valor é 65535.
- ServiceFabricApplicationDescription – filtro que corresponde à entrada com o valor ApplicationDefinitionKind ServiceFabricApplicationDescription. O valor é 1.
- Composição - Filtro que corresponde à entrada com o valor ApplicationDefinitionKind Compose. O valor é 2.
--application-type-name O nome do tipo de aplicação utilizado para filtrar as aplicações para consulta. Este valor não deve conter a versão do tipo de aplicação.
--continuation-token O parâmetro do token de continuação é utilizado 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 numa única resposta. Quando este valor é transmitido para a próxima chamada à API, a API devolve o próximo conjunto de resultados. Se não existirem mais resultados, o token de continuação não contém um valor. O valor deste parâmetro não deve ser codificado por URL.
--exclude-application-parameters O sinalizador que especifica se os parâmetros da aplicação serão excluídos do resultado.
--max-results O número máximo de resultados a devolver como parte das consultas paginadas. Este parâmetro define o limite superior no número de resultados devolvidos. Os resultados devolvidos podem ser inferiores aos resultados máximos especificados se não se ajustarem à mensagem de acordo com as restrições de tamanho máximo da mensagem definidas na configuração. Se este parâmetro for zero ou não for especificado, a consulta paginada inclui o maior número possível de resultados que se enquadram na mensagem de retorno.
--timeout -t O tempo limite do servidor para executar a operação em segundos. Este tempo limite especifica a duração de tempo que o cliente está disposto a aguardar pela conclusão da operação pedida. O valor predefinido para este parâmetro é 60 segundos. Predefinição: 60.

Argumentos Globais

Argumento Description
--depurar Aumente a verbosidade do registo para mostrar todos os registos de depuração.
--help -h Mostrar esta mensagem de ajuda e sair.
--output -o Formato de saída. Valores permitidos: json, jsonc, table, tsv. Predefinição: json.
--consulta Cadeia de consulta JMESPath. Veja http://jmespath.org/ para obter mais informações e exemplos.
--verboso Aumentar a verbosidade do registo. Utilize --debug para registos de depuração completos.

carregamento da aplicação sfctl

Obtém informações de carregamento sobre uma aplicação do Service Fabric.

Devolve as informações de carga sobre a aplicação que foi criada ou no processo de criação no cluster do Service Fabric e cujo nome corresponde ao especificado como o parâmetro . A resposta inclui o nome, os nós mínimos, os nós máximos, o número de nós que a aplicação está a ocupar atualmente e as informações da métrica de carregamento da aplicação sobre a aplicação.

Argumentos

Argumento Description
--application-id [Necessário] A identidade da aplicação. Normalmente, este é o nome completo da aplicação sem o esquema de URI "fabric:". A partir da versão 6.0, os nomes hierárquicos são delimitados com o caráter "~". Por exemplo, se o nome da aplicação for "fabric:/myapp/app1", a identidade da aplicação será "myapp~app1" na versão 6.0+ e "myapp/app1" em versões anteriores.
--timeout -t O tempo limite do servidor para executar a operação em segundos. Este tempo limite especifica a duração de tempo que o cliente está disposto a aguardar que a operação pedida seja concluída. O valor predefinido para este parâmetro é 60 segundos. Predefinição: 60.

Argumentos Globais

Argumento Description
--debug Aumente a verbosidade do registo para mostrar todos os registos de depuração.
--help -h Mostrar esta mensagem de ajuda e sair.
--output -o Formato de saída. Valores permitidos: json, jsonc, table, tsv. Predefinição: json.
--query Cadeia de consulta JMESPath. Veja http://jmespath.org/ para obter mais informações e exemplos.
--verboso Aumentar a verbosidade do registo. Utilize --debug para registos de depuração completos.

manifesto da aplicação sfctl

Obtém o manifesto que descreve um tipo de aplicação.

A resposta contém o XML do manifesto da aplicação como uma cadeia.

Argumentos

Argumento Description
--application-type-name [Necessário] O nome do tipo de aplicação.
--application-type-version [Necessário] A versão do tipo de aplicação.
--timeout -t O tempo limite do servidor para executar a operação em segundos. Este tempo limite especifica a duração de tempo que o cliente está disposto a aguardar que a operação pedida seja concluída. O valor predefinido para este parâmetro é 60 segundos. Predefinição: 60.

Argumentos Globais

Argumento Description
--debug Aumente a verbosidade do registo para mostrar todos os registos de depuração.
--help -h Mostrar esta mensagem de ajuda e sair.
--output -o Formato de saída. Valores permitidos: json, jsonc, table, tsv. Predefinição: json.
--query Cadeia de consulta JMESPath. Veja http://jmespath.org/ para obter mais informações e exemplos.
--verboso Aumentar a verbosidade do registo. Utilize --debug para registos de depuração completos.

aprovisionamento de aplicações sfctl

Aprovisiona ou regista um tipo de aplicação do Service Fabric com o cluster com o pacote ".sfpkg" no arquivo externo ou com o pacote de aplicação no arquivo de imagens.

Aprovisiona um tipo de aplicação do Service Fabric com o cluster. A aprovisionamento é necessária antes de as novas aplicações poderem ser instanciadas. A operação de aprovisionamento pode ser efetuada no pacote de aplicação especificado pelo relativePathInImageStore ou através do URI do ".sfpkg" externo. A menos que --external-provision esteja definido, este comando irá esperar o aprovisionamento do arquivo de imagens.

Argumentos

Argumento Description
--application-package-download-uri O caminho para o pacote de aplicação ".sfpkg" a partir do qual o pacote de aplicação pode ser transferido através de protocolos HTTP ou HTTPS.

Apenas para armazenamento externo de tipo de aprovisionamento. O pacote de aplicação pode ser armazenado num arquivo externo que fornece a operação GET para transferir o ficheiro. Os protocolos suportados são HTTP e HTTPS e o caminho tem de permitir o acesso DE LEITURA.
--application-type-build-path Apenas para o armazenamento de imagens de tipo de aprovisionamento. O caminho relativo para o pacote de aplicação no arquivo de imagens especificado durante a operação de carregamento anterior.
--application-type-name Apenas para armazenamento externo de tipo de aprovisionamento. O nome do tipo de aplicação representa o nome do tipo de aplicação encontrado no manifesto da aplicação.
--application-type-version Apenas para armazenamento externo de tipo de aprovisionamento. A versão do tipo de aplicação representa a versão do tipo de aplicação encontrada no manifesto da aplicação.
--external-provision A localização a partir da qual o pacote de aplicação pode ser registado ou aprovisionado. Indica que o aprovisionamento se destina a um pacote de aplicações que foi anteriormente carregado para um arquivo externo. O pacote de aplicação termina com a extensão *.sfpkg.
--no-wait Indica se o aprovisionamento deve ou não ocorrer de forma assíncrona.

Quando definida como verdadeira, a operação de aprovisionamento devolve quando o pedido é aceite pelo sistema e a operação de aprovisionamento continua sem qualquer limite de tempo limite. O valor predefinido é false. Para pacotes de aplicações grandes, recomendamos que defina o valor como verdadeiro.
--timeout -t Predefinição: 60.

Argumentos Globais

Argumento Description
--depurar Aumente a verbosidade do registo para mostrar todos os registos de depuração.
--help -h Mostrar esta mensagem de ajuda e sair.
--output -o Formato de saída. Valores permitidos: json, jsonc, table, tsv. Predefinição: json.
--consulta Cadeia de consulta JMESPath. Veja http://jmespath.org/ para obter mais informações e exemplos.
--verboso Aumente a verbosidade do registo. Utilize --debug para registos de depuração completos.

sfctl application report-health

Envia um relatório de estado de funcionamento na aplicação do Service Fabric.

Comunica o estado de funcionamento da aplicação do Service Fabric especificada. O relatório tem de conter as informações sobre a origem do relatório de estado de funcionamento e da propriedade na qual é comunicado. O relatório é enviado para uma Aplicação de gateway do Service Fabric, que é reencaminhada para o arquivo de estado de funcionamento. O relatório pode ser aceite pelo gateway, mas rejeitado pelo arquivo de estado de funcionamento após validação adicional. Por exemplo, o arquivo de estado de funcionamento 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 arquivo de estado de funcionamento, obtenha o estado de funcionamento da aplicação e verifique se o relatório é apresentado.

Argumentos

Argumento Description
--application-id [Necessário] A identidade da aplicação.

Normalmente, este é o nome completo da aplicação sem o esquema de URI "fabric:". A partir da versão 6.0, os nomes hierárquicos são delimitados com o caráter '~'. Por exemplo, se o nome da aplicação for "fabric:/myapp/app1", a identidade da aplicação será "myapp~app1" em 6.0+ e "myapp/app1" em versões anteriores.
--health-property [Necessário] A propriedade das informações de estado de funcionamento.

Uma entidade pode ter relatórios de estado de funcionamento para propriedades diferentes. A propriedade é uma cadeia e não uma enumeração fixa para permitir que a flexibilidade do repórter categorize a condição de estado que aciona o relatório. Por exemplo, um repórter com o SourceId "LocalWatchdog" pode monitorizar o estado do disco disponível num nó, para que possa comunicar a propriedade "AvailableDisk" nesse nó. O mesmo repórter pode monitorizar a conectividade do nó, para que possa comunicar uma propriedade "Conectividade" no mesmo nó. No arquivo de estado de funcionamento, estes relatórios são tratados como eventos de estado de funcionamento separados para o nó especificado. Juntamente com o SourceId, a propriedade identifica exclusivamente as informações de estado de funcionamento.
--health-state [Necessário] Os valores possíveis incluem: "Inválido", "Ok", "Aviso", "Erro", "Desconhecido".
--source-id [Necessário] O nome de origem que identifica o componente cliente/watchdog/sistema que gerou as informações de estado de funcionamento.
--description A descrição das informações de estado de funcionamento.

Representa texto gratuito utilizado para adicionar informações legíveis por humanos sobre o relatório. O comprimento máximo da cadeia para a descrição é de 4096 carateres. Se a cadeia fornecida for mais longa, será truncada automaticamente. Quando truncados, os últimos carateres da descrição contêm um marcador "[Truncado]" e o tamanho total da cadeia é de 4096 carateres. A presença do marcador indica aos utilizadores que ocorreu uma truncagem. Tenha em atenção que, quando truncada, a descrição tem menos de 4096 carateres da cadeia original.
--imediato Um sinalizador que indica se o relatório deve ser enviado imediatamente.

É enviado um relatório de estado de funcionamento para uma Aplicação de gateway do Service Fabric, que é reencaminhada para o arquivo de estado de funcionamento. Se Imediato estiver definido como verdadeiro, o relatório é enviado imediatamente do Gateway DE HTTP para o arquivo de estado de funcionamento, independentemente das definições de cliente de recursos de infraestrutura que a Aplicação de Gateway DE HTTP está a utilizar. Isto é útil para relatórios críticos que devem ser enviados o mais rapidamente possível. Consoante a temporização e outras condições, o envio do relatório pode continuar a falhar, por exemplo, se o Gateway DE HTTP estiver fechado ou a mensagem não chegar ao Gateway. Se Imediato estiver definido como falso, o relatório é enviado com base nas definições do cliente de estado de funcionamento do Gateway HTTP. Por conseguinte, será em lote de acordo com a configuração HealthReportSendInterval. Esta é a definição recomendada porque permite ao cliente de estado de funcionamento otimizar as mensagens de relatórios de estado de funcionamento para o arquivo de estado de funcionamento, bem como o processamento de relatórios de estado de funcionamento. Por predefinição, os relatórios não são enviados imediatamente.
--remove-when-expired Valor que indica se o relatório é removido do arquivo de estado de funcionamento quando expira.

Se definido como verdadeiro, o relatório é removido do arquivo de estado de funcionamento depois de expirar. Se estiver definido como falso, o relatório será tratado como um erro quando expirado. Por predefinição, o valor desta propriedade é falso. Quando os clientes comunicam periodicamente, devem definir RemoveWhenExpired false (predefinição). Desta forma, o repórter tem problemas (por exemplo, impasse) e não consegue comunicar, a entidade é avaliada por erro quando o relatório de estado de funcionamento expira. Isto sinaliza a entidade como estando no estado de funcionamento do erro.
--sequence-number O número de sequência para este relatório de estado de funcionamento como uma cadeia numérica.

O número da sequência de relatórios é utilizado pelo arquivo de estado de funcionamento para detetar relatórios obsoletos. Se não for especificado, um número de sequência é gerado automaticamente pelo cliente de estado de funcionamento quando é adicionado um relatório.
--timeout -t Predefinição: 60.
--ttl A duração para a qual este relatório de estado de funcionamento é válido. Este campo utiliza o formato ISO8601 para especificar a duração.

Quando os clientes comunicam periodicamente, devem enviar relatórios com maior frequência do que o tempo de vida. Se os clientes comunicarem sobre a transição, podem definir o tempo de vida como infinito. Quando o tempo de vida expira, o evento de estado de funcionamento que contém as informações de estado de funcionamento é removido do arquivo de estado de funcionamento, se RemoveWhenExpired for verdadeiro ou avaliado por erro, se RemoveWhenExpired false. Se não for especificado, a hora de viver é predefinida para o valor infinito.

Argumentos Globais

Argumento Description
--depurar Aumente a verbosidade do registo para mostrar todos os registos de depuração.
--help -h Mostrar esta mensagem de ajuda e sair.
--output -o Formato de saída. Valores permitidos: json, jsonc, table, tsv. Predefinição: json.
--query Cadeia de consulta JMESPath. Veja http://jmespath.org/ para obter mais informações e exemplos.
--verboso Aumentar a verbosidade do registo. Utilize --debug para registos de depuração completos.

tipo de aplicação sfctl

Obtém a lista de tipos de aplicações no cluster do Service Fabric que correspondem exatamente ao nome especificado.

Devolve as informações sobre os tipos de aplicações que são aprovisionados ou no processo de aprovisionamento no cluster do Service Fabric. Estes resultados são de tipos de aplicações cujo nome corresponde exatamente ao especificado como o parâmetro e que estão em conformidade com os parâmetros de consulta especificados. São devolvidas todas as versões do tipo de aplicação que correspondem ao nome do tipo de aplicação, sendo que cada versão é devolvida como um tipo de aplicação. A resposta inclui o nome, a versão, o estado e outros detalhes sobre o tipo de aplicação. Esta é uma consulta paginada, o que significa que, se nem todos os tipos de aplicações caberem numa página, é devolvida uma página de resultados, bem como um token de continuação, que pode ser utilizado para obter a página seguinte. Por exemplo, se existirem 10 tipos de aplicações, mas uma página se ajustar apenas aos três primeiros tipos de aplicação ou se o máximo de resultados estiver definido como 3, serão devolvidos três. Para aceder ao resto dos resultados, obtenha as páginas subsequentes com o token de continuação devolvido na consulta seguinte. Um token de continuação vazio é devolvido se não existirem páginas subsequentes.

Argumentos

Argumento Description
--application-type-name [Necessário] O nome do tipo de aplicação.
--application-type-version A versão do tipo de aplicação.
--continuation-token O parâmetro do token de continuação é utilizado 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 numa única resposta. Quando este valor é transmitido para a próxima chamada à API, a API devolve o próximo conjunto de resultados. Se não existirem mais resultados, o token de continuação não contém um valor. O valor deste parâmetro não deve ser codificado por URL.
--exclude-application-parameters O sinalizador que especifica se os parâmetros da aplicação serão excluídos do resultado.
--max-results O número máximo de resultados a devolver como parte das consultas paginadas. Este parâmetro define o limite superior no número de resultados devolvidos. Os resultados devolvidos podem ser inferiores aos resultados máximos especificados se não caberem na mensagem de acordo com as restrições de tamanho máximo de mensagens definidas na configuração. Se este parâmetro for zero ou não for especificado, a consulta paginada inclui o maior número possível de resultados que cabem na mensagem de retorno.
--timeout -t O tempo limite do servidor para executar a operação em segundos. Este tempo limite especifica a duração de tempo que o cliente está disposto a aguardar que a operação pedida seja concluída. O valor predefinido para este parâmetro é 60 segundos. Predefinição: 60.

Argumentos Globais

Argumento Description
--debug Aumente a verbosidade do registo para mostrar todos os registos de depuração.
--help -h Mostrar esta mensagem de ajuda e sair.
--output -o Formato de saída. Valores permitidos: json, jsonc, table, tsv. Predefinição: json.
--query Cadeia de consulta JMESPath. Veja http://jmespath.org/ para obter mais informações e exemplos.
--verboso Aumentar a verbosidade do registo. Utilize --debug para registos de depuração completos.

sfctl application type-list

Obtém a lista de tipos de aplicações no cluster do Service Fabric.

Devolve as informações sobre os tipos de aplicações que são aprovisionados ou no processo de aprovisionamento no cluster do Service Fabric. Cada versão de um tipo de aplicação é devolvida como um tipo de aplicação. A resposta inclui o nome, a versão, o estado e outros detalhes sobre o tipo de aplicação. Esta é uma consulta paginada, o que significa que, se nem todos os tipos de aplicações caberem numa página, é devolvida uma página de resultados, bem como um token de continuação, que pode ser utilizado para obter a página seguinte. Por exemplo, se existirem 10 tipos de aplicações, mas uma página se ajustar apenas aos três primeiros tipos de aplicação ou se o máximo de resultados estiver definido como 3, serão devolvidos três. Para aceder ao resto dos resultados, obtenha as páginas subsequentes com o token de continuação devolvido na consulta seguinte. Um token de continuação vazio é devolvido se não existirem páginas subsequentes.

Argumentos

Argumento Description
--application-type-definition-kind-filter Utilizado para filtrar em ApplicationTypeDefinitionKind, que é o mecanismo utilizado para definir um tipo de aplicação do Service Fabric.
- Predefinição - Valor predefinido, que executa a mesma função que selecionar "Todos". O valor é 0.
- Todos - Filtro que corresponde à entrada com qualquer valor ApplicationTypeDefinitionKind. O valor é 65535.
- ServiceFabricApplicationPackage - Filtro que corresponde à entrada com o valor ApplicationTypeDefinitionKind ServiceFabricApplicationPackage. O valor é 1.
- Compor - Filtro que corresponde à entrada com o valor ApplicationTypeDefinitionKind Compose. O valor é 2.
--continuation-token O parâmetro do token de continuação é utilizado 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 numa única resposta. Quando este valor é transmitido para a próxima chamada à API, a API devolve o próximo conjunto de resultados. Se não existirem mais resultados, o token de continuação não contém um valor. O valor deste parâmetro não deve ser codificado por URL.
--exclude-application-parameters O sinalizador que especifica se os parâmetros da aplicação serão excluídos do resultado.
--max-results O número máximo de resultados a devolver como parte das consultas paginadas. Este parâmetro define o limite superior no número de resultados devolvidos. Os resultados devolvidos podem ser inferiores aos resultados máximos especificados se não caberem na mensagem de acordo com as restrições de tamanho máximo de mensagens definidas na configuração. Se este parâmetro for zero ou não for especificado, a consulta paginada inclui o maior número possível de resultados que cabem na mensagem de retorno.
--timeout -t O tempo limite do servidor para executar a operação em segundos. Este tempo limite especifica a duração de tempo que o cliente está disposto a aguardar que a operação pedida seja concluída. O valor predefinido para este parâmetro é 60 segundos. Predefinição: 60.

Argumentos Globais

Argumento Description
--depurar Aumente a verbosidade do registo para mostrar todos os registos de depuração.
--help -h Mostrar esta mensagem de ajuda e sair.
--output -o Formato de saída. Valores permitidos: json, jsonc, table, tsv. Predefinição: json.
--consulta Cadeia de consulta JMESPath. Veja http://jmespath.org/ para obter mais informações e exemplos.
--verboso Aumente a verbosidade do registo. Utilize --debug para registos de depuração completos.

sfctl application unprovision

Remove ou anule o registo de um tipo de aplicação do Service Fabric do cluster.

Esta operação só pode ser efetuada se todas as instâncias da aplicação do tipo de aplicação tiverem sido eliminadas. Assim que o tipo de aplicação não estiver registado, não podem ser criadas novas instâncias de aplicação para este tipo de aplicação específico.

Argumentos

Argumento Description
--application-type-name [Obrigatório] O nome do tipo de aplicação.
--application-type-version [Necessário] A versão do tipo de aplicação, conforme definido no manifesto da aplicação.
--async-parameter O sinalizador que indica se a não aprovisionamento deve ou não ocorrer de forma assíncrona. Quando definida como verdadeira, a operação de não aprovisionamento devolve quando o pedido é aceite pelo sistema e a operação de não aprovisionamento continua sem qualquer limite de tempo limite. O valor predefinido é false. No entanto, recomendamos que o defina como verdadeiro para pacotes de aplicações grandes que foram aprovisionados.
--timeout -t O tempo limite do servidor para executar a operação em segundos. Este tempo limite especifica a duração de tempo que o cliente está disposto a aguardar pela conclusão da operação pedida. O valor predefinido para este parâmetro é 60 segundos. Predefinição: 60.

Argumentos Globais

Argumento Description
--depurar Aumente a verbosidade do registo para mostrar todos os registos de depuração.
--help -h Mostrar esta mensagem de ajuda e sair.
--output -o Formato de saída. Valores permitidos: json, jsonc, table, tsv. Predefinição: json.
--consulta Cadeia de consulta JMESPath. Veja http://jmespath.org/ para obter mais informações e exemplos.
--verboso Aumente a verbosidade do registo. Utilize --debug para registos de depuração completos.

atualização da aplicação sfctl

Começa a atualizar uma aplicação no cluster do Service Fabric.

Valida os parâmetros de atualização da aplicação fornecidos e começa a atualizar a aplicação se os parâmetros forem válidos. Tenha em atenção que a descrição da atualização substitui a descrição da aplicação existente. Isto significa que, se os parâmetros não forem especificados, os parâmetros existentes nas aplicações serão substituídos pela lista de parâmetros vazios. Tal resultaria na aplicação com o valor predefinido dos parâmetros do manifesto da aplicação.

Argumentos

Argumento Description
--application-id [Necessário] A identidade da aplicação.

Normalmente, este é o nome completo da aplicação sem o esquema de URI "fabric:". A partir da versão 6.0, os nomes hierárquicos são delimitados com o caráter "~". Por exemplo, se o nome da aplicação for "fabric:/myapp/app1", a identidade da aplicação será "myapp~app1" em 6.0+ e "myapp/app1" em versões anteriores.
--application-version [Necessário] A versão do tipo de aplicação de destino (encontrada no manifesto da aplicação) para a atualização da aplicação.
--parâmetros [Obrigatório] Uma lista codificada JSON de substituições de parâmetros de aplicação a aplicar ao atualizar a aplicação.
--default-service-health-policy Especificação codificada JSON da política de estado de funcionamento utilizada por predefinição para avaliar o estado de funcionamento de um tipo de serviço.
--failure-action A ação a executar quando uma Atualização monitorizada encontra violações da política de monitorização ou da política de estado de funcionamento.
--force-restart Reinicia os processos com força durante a atualização, mesmo quando a versão do código não foi alterada.
--health-check-retry-timeout O período de tempo entre tentativas de efetuar verificações de estado de funcionamento se a aplicação ou o cluster não estiver em bom estado de funcionamento. Predefinição: PT0H10M0S.
--health-check-stable-duration O período de tempo durante o qual a aplicação ou cluster tem de permanecer em bom estado de funcionamento antes de a atualização avançar para o domínio de atualização seguinte. Predefinição: PT0H2M0S.

É interpretado pela primeira vez como uma cadeia que representa uma duração ISO 8601. Se isso falhar, será interpretado como um número que representa o número total de milissegundos.
--health-check-wait-duration O período de tempo a aguardar depois de concluir um domínio de atualização antes de iniciar o processo de verificação de estado de funcionamento. Predefinição: 0.
--max-unhealthy-apps A percentagem máxima permitida de aplicações implementadas em mau estado de funcionamento. Representado como um número entre 0 e 100.
--mode O modo utilizado para monitorizar o estado de funcionamento durante uma atualização sem interrupção. Predefinição: UnmonitoredAuto.
--replica-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 existem problemas inesperados. Medido em segundos.
--service-health-policy Mapa codificado JSON com política de estado de funcionamento do tipo de serviço por nome do tipo de serviço. O mapa está vazio por predefinição.
--timeout -t Predefinição: 60.
--upgrade-domain-timeout A quantidade de tempo que cada domínio de atualização tem de concluir antes da execução de FailureAction. Predefinição: P10675199DT02H48M05.4775807S.

É interpretado pela primeira vez como uma cadeia que representa uma duração ISO 8601. Se isso falhar, será interpretado como um número que representa o número total de milissegundos.
--upgrade-timeout A quantidade de tempo que a atualização geral tem de ser concluída antes de FailureAction ser executada. Predefinição: P10675199DT02H48M05.4775807S.

É interpretado pela primeira vez como uma cadeia que representa uma duração ISO 8601. Se isso falhar, será interpretado como um número que representa o número total de milissegundos.
--warning-as-error Indica se os avisos são tratados com a mesma gravidade que os erros.

Argumentos Globais

Argumento Description
--depurar Aumente a verbosidade do registo para mostrar todos os registos de depuração.
--help -h Mostrar esta mensagem de ajuda e sair.
--output -o Formato de saída. Valores permitidos: json, jsonc, table, tsv. Predefinição: json.
--consulta Cadeia de consulta JMESPath. Veja http://jmespath.org/ para obter mais informações e exemplos.
--verboso Aumente a verbosidade do registo. Utilize --debug para registos de depuração completos.

sfctl application upgrade-resume

Retoma a atualização de uma aplicação no cluster do Service Fabric.

Retoma uma atualização manual não monitorizada da aplicação do Service Fabric. O Service Fabric atualiza um domínio de atualização de cada vez. Para atualizações manuais não monitorizadas, após o Service Fabric concluir um domínio de atualização, aguarda que chame esta API antes de avançar para o domínio de atualização seguinte.

Argumentos

Argumento Description
--application-id [Necessário] A identidade da aplicação. Normalmente, este é o nome completo da aplicação sem o esquema de URI "fabric:". A partir da versão 6.0, os nomes hierárquicos são delimitados com o caráter "~". Por exemplo, se o nome da aplicação for "fabric:/myapp/app1", a identidade da aplicação será "myapp~app1" em 6.0+ e "myapp/app1" em versões anteriores.
--upgrade-domain-name [Obrigatório] O nome do domínio de atualização no qual pretende retomar a atualização.
--timeout -t O tempo limite do servidor para executar a operação em segundos. Este tempo limite especifica a duração de tempo que o cliente está disposto a aguardar pela conclusão da operação pedida. O valor predefinido para este parâmetro é 60 segundos. Predefinição: 60.

Argumentos Globais

Argumento Description
--depurar Aumente a verbosidade do registo para mostrar todos os registos de depuração.
--help -h Mostrar esta mensagem de ajuda e sair.
--output -o Formato de saída. Valores permitidos: json, jsonc, table, tsv. Predefinição: json.
--consulta Cadeia de consulta JMESPath. Veja http://jmespath.org/ para obter mais informações e exemplos.
--verboso Aumente a verbosidade do registo. Utilize --debug para registos de depuração completos.

atualização-reversão da aplicação sfctl

Começa a reverter a atualização atualmente em curso de uma aplicação no cluster do Service Fabric.

Começa a reverter a atualização atual da aplicação para a versão anterior. Esta API só pode ser utilizada para reverter a atualização atual em curso que está a avançar para a nova versão. Se a aplicação não estiver atualmente a ser atualizada, utilize a API StartApplicationUpgrade para atualizá-la para a versão pretendida, incluindo reverter para uma versão anterior.

Argumentos

Argumento Description
--application-id [Necessário] A identidade da aplicação. Normalmente, este é o nome completo da aplicação sem o esquema de URI "fabric:". A partir da versão 6.0, os nomes hierárquicos são delimitados com o caráter "~". Por exemplo, se o nome da aplicação for "fabric:/myapp/app1", a identidade da aplicação será "myapp~app1" em 6.0+ e "myapp/app1" em versões anteriores.
--timeout -t O tempo limite do servidor para executar a operação em segundos. Este tempo limite especifica a duração de tempo que o cliente está disposto a aguardar pela conclusão da operação pedida. O valor predefinido para este parâmetro é 60 segundos. Predefinição: 60.

Argumentos Globais

Argumento Description
--depurar Aumente a verbosidade do registo para mostrar todos os registos de depuração.
--help -h Mostrar esta mensagem de ajuda e sair.
--output -o Formato de saída. Valores permitidos: json, jsonc, table, tsv. Predefinição: json.
--consulta Cadeia de consulta JMESPath. Veja http://jmespath.org/ para obter mais informações e exemplos.
--verboso Aumente a verbosidade do registo. Utilize --debug para registos de depuração completos.

sfctl application upgrade-status

Obtém detalhes sobre a atualização mais recente efetuada nesta aplicação.

Devolve informações sobre o estado da atualização mais recente da aplicação, juntamente com detalhes para ajudar a depurar problemas de estado de funcionamento da aplicação.

Argumentos

Argumento Description
--application-id [Necessário] A identidade da aplicação. Normalmente, este é o nome completo da aplicação sem o esquema de URI "fabric:". A partir da versão 6.0, os nomes hierárquicos são delimitados com o caráter "~". Por exemplo, se o nome da aplicação for "fabric:/myapp/app1", a identidade da aplicação será "myapp~app1" em 6.0+ e "myapp/app1" em versões anteriores.
--timeout -t O tempo limite do servidor para executar a operação em segundos. Este tempo limite especifica a duração de tempo que o cliente está disposto a aguardar pela conclusão da operação pedida. O valor predefinido para este parâmetro é 60 segundos. Predefinição: 60.

Argumentos Globais

Argumento Description
--depurar Aumente a verbosidade do registo para mostrar todos os registos de depuração.
--help -h Mostrar esta mensagem de ajuda e sair.
--output -o Formato de saída. Valores permitidos: json, jsonc, table, tsv. Predefinição: json.
--consulta Cadeia de consulta JMESPath. Veja http://jmespath.org/ para obter mais informações e exemplos.
--verboso Aumente a verbosidade do registo. Utilize --debug para registos de depuração completos.

carregamento da aplicação sfctl

Copie um pacote de aplicação do Service Fabric para o arquivo de imagens.

Opcionalmente, apresenta o progresso do carregamento para cada ficheiro no pacote. O progresso do carregamento é enviado para stderr.

Argumentos

Argumento Description
--path [Obrigatório] Caminho para o pacote de aplicação local.
--comprimir Aplicável apenas aos pacotes de aplicações do Service Fabric. Crie uma nova pasta que contenha o pacote de aplicação comprimido para a localização predefinida ou para a localização especificada pelo parâmetro de localização comprimida e, em seguida, carregue a pasta criada recentemente.

Se já existir um ficheiro comprimido gerado pelo sfctl, será substituído se este sinalizador estiver definido. Será devolvido um erro se o diretório não for um pacote de aplicação. Se já for um pacote de aplicação comprimido, a pasta será copiada tal como está. Por predefinição, o pacote de aplicações comprimido recentemente criado será eliminado após um carregamento bem-sucedido. Se o carregamento não for bem-sucedido, limpe manualmente o pacote comprimido conforme necessário. A eliminação não remove dirs vazios que possam ter sido criados se o parâmetro de localização comprimido referenciar diretórios inexistentes.
--compressed-location A localização para colocar o pacote de aplicação comprimido.

Se não for fornecida nenhuma localização, o pacote comprimido será colocado sob uma pasta criada recentemente denominada sfctl_compressed_temp no diretório principal especificado no argumento caminho. Por exemplo, se o argumento caminho tiver o valor C:/FolderA/AppPkg, o pacote comprimido será adicionado a C:/FolderA/sfctl_compressed_temp/AppPkg.
--imagestore-string Arquivo de imagens de destino para onde carregar o pacote de aplicação. Predefinição: recursos de infraestrutura:ImageStore.

Para carregar para uma localização de ficheiro, inicie este parâmetro com "file:". Caso contrário, o valor deve ser a cadeia de ligação do arquivo de imagens, como o valor predefinido.
--keep-compress Quer mantenha ou não o pacote comprimido gerado na conclusão do carregamento com êxito.

Se não estiver definido, após a conclusão com êxito, os pacotes de aplicações comprimidos serão eliminados. Se o carregamento não tiver sido bem-sucedido, o pacote de aplicação será sempre mantido no diretório de saída para recarregar.
--show-progress Mostrar o progresso do carregamento de ficheiros para pacotes grandes.
--timeout -t O tempo limite total em segundos. O carregamento irá falhar e devolver o erro após a duração do tempo limite do carregamento ter passado. Este tempo limite aplica-se a todo o pacote de aplicações e os tempos limite de ficheiros individuais serão iguais à duração restante do tempo limite. O tempo limite não inclui o tempo necessário para comprimir o pacote de aplicação. Predefinição: 300.

Argumentos Globais

Argumento Description
--depurar Aumente a verbosidade do registo para mostrar todos os registos de depuração.
--help -h Mostrar esta mensagem de ajuda e sair.
--output -o Formato de saída. Valores permitidos: json, jsonc, table, tsv. Predefinição: json.
--consulta Cadeia de consulta JMESPath. Veja http://jmespath.org/ para obter mais informações e exemplos.
--verboso Aumente a verbosidade do registo. Utilize --debug para registos de depuração completos.

Passos seguintes