composição sfctl
Criar, excluir e gerenciar aplicativos do Docker Compose.
Comandos
| Comando | Descrição |
|---|---|
| create | Cria uma implantação de composição do Service Fabric. |
| list | Obtém a lista de implantação de composição criada no cluster do Service Fabric. |
| remove | Exclui uma implantação de composição existente do Service Fabric do cluster. |
| status | Obtém informações sobre um aplicativo de implantação do Service Fabric. |
| atualização | Começa a atualização de uma implantação de composição no cluster do Service Fabric. |
| upgrade-rollback | Começa a reversão de uma atualização de implantação de composição no cluster do Service Fabric. |
| upgrade-status | Obtém detalhes para a atualização mais recente realizada na implantação da composição do Service Fabric. |
criar composição sfctl
Cria uma implantação de composição do Service Fabric.
Argumentos
| Argument | Descrição |
|---|---|
| --nome de implantação [obrigatório] | O nome da implantação. |
| --caminho de arquivo [obrigatório] | Caminho para o arquivo de destino do Docker Compose. |
| -senha criptografada | Em vez de solicitar uma senha de registro do contêiner, use uma frase secreta já criptografada. |
| --has-pass | Solicitará uma senha para o registro de contêiner. |
| --timeout -t | Padrão: 60. |
| --user | Nome de usuário para conectar o registro de contêiner. |
Argumentos globais
| Argumento | Descrição |
|---|---|
| --debug | Aumente o detalhamento do log para mostrar todos os logs de depuração. |
| --help -h | Mostrar esta mensagem de ajuda e sair. |
| --output -o | Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json. |
| --query | Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos. |
| --verbose | Aumentar o detalhamento do log. Use --debug para logs de depuração completos. |
lista de composição sfctl
Obtém a lista de implantação de composição criada no cluster do Service Fabric.
Obtém o status sobre as implantações de redação que foram criadas ou no processo de criação do cluster do Service Fabric. A resposta inclui o nome, o status e outros detalhes sobre a implantação de composição. Se a lista de implantações não couber em uma página, uma página de resultados é retornada, bem como um token de continuação que pode ser usado para a próxima página.
Argumentos
| Argument | Descrição |
|---|---|
| --continuation-token | O parâmetro do token de continuação é usado para obter o próximo conjunto de resultados. Um token de continuação com um valor não vazio será incluso na resposta da API quando os resultados do sistema não couberem em uma única resposta. Quando esse valor for passado para a próxima chamada de API, a API retornará 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 em URL. |
| --max-results | O número máximo de resultados a serem retornados como parte das consultas paginadas. Esse parâmetro define o limite superior no número de resultados retornados. Os resultados retornados podem ser inferiores aos resultados máximos especificados se não couberem na mensagem, de acordo com as restrições de tamanho máximo de mensagem definidas na configuração. Se esse parâmetro for zero, ou não for especificado, a consulta paginada incluirá o máximo de resultados possível na mensagem de retorno. |
| --timeout -t | Tempo limite do servidor para executar a operação em segundos. Especifica o tempo que o cliente está disposto a esperar para que operação solicitada seja concluída. O valor padrão desse parâmetro é 60 segundos. Padrão: 60. |
Argumentos globais
| Argumento | Descrição |
|---|---|
| --debug | Aumente o detalhamento do log para mostrar todos os logs de depuração. |
| --help -h | Mostrar esta mensagem de ajuda e sair. |
| --output -o | Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json. |
| --query | Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos. |
| --verbose | Aumentar o detalhamento do log. Use --debug para logs de depuração completos. |
remoção de composição sfctl
Exclui uma implantação de composição existente do Service Fabric do cluster.
Exclui uma implantação de composição existente do Service Fabric.
Argumentos
| Argument | Descrição |
|---|---|
| --nome de implantação [obrigatório] | A identidade da implantação. |
| --timeout -t | Tempo limite do servidor para executar a operação em segundos. Especifica o tempo que o cliente está disposto a esperar para que operação solicitada seja concluída. O valor padrão desse parâmetro é 60 segundos. Padrão: 60. |
Argumentos globais
| Argumento | Descrição |
|---|---|
| --debug | Aumente o detalhamento do log para mostrar todos os logs de depuração. |
| --help -h | Mostrar esta mensagem de ajuda e sair. |
| --output -o | Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json. |
| --query | Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos. |
| --verbose | Aumentar o detalhamento do log. Use --debug para logs de depuração completos. |
status de composição sfctl
Obtém informações sobre um aplicativo de implantação do Service Fabric.
Retorna o status da implantação de composição que foi criada ou em processo de criação no cluster do Service Fabric e cujo nome corresponde ao especificado como o parâmetro. A resposta inclui o nome, status e outros detalhes sobre a implantação.
Argumentos
| Argument | Descrição |
|---|---|
| --nome de implantação [obrigatório] | A identidade da implantação. |
| --timeout -t | Tempo limite do servidor para executar a operação em segundos. Especifica o tempo que o cliente está disposto a esperar para que operação solicitada seja concluída. O valor padrão desse parâmetro é 60 segundos. Padrão: 60. |
Argumentos globais
| Argumento | Descrição |
|---|---|
| --debug | Aumente o detalhamento do log para mostrar todos os logs de depuração. |
| --help -h | Mostrar esta mensagem de ajuda e sair. |
| --output -o | Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json. |
| --query | Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos. |
| --verbose | Aumentar o detalhamento do log. Use --debug para logs de depuração completos. |
upgrade de composição sfctl
Começa a atualização de uma implantação de composição no cluster do Service Fabric.
Valida os parâmetros de atualização fornecidos e inicia a atualização da implantação, se os parâmetros são válidos.
Argumentos
| Argument | Descrição |
|---|---|
| --nome de implantação [obrigatório] | O nome da implantação. |
| --caminho de arquivo [obrigatório] | Caminho para o arquivo de destino do Docker Compose. |
| --falha-svc-tipo-integridade-mapa | Dicionário codificado JSON que descreve a política de integridade usada para avaliar a integridade dos serviços. |
| -senha criptografada | Em vez de solicitar uma senha de registro do contêiner, use uma frase secreta já criptografada. |
| --ação de falha | Os valores possíveis incluem: 'Inválido', 'Reversão', 'Manual'. |
| -força-reinicialização | Os processos são reiniciados de modo forçado durante a atualização, mesmo quando a versão do código não foi alterada. A atualização altera apenas a configuração ou os dados. |
| --has-pass | Solicitará uma senha para o registro de contêiner. |
| --nova tentativa de verificação da integridade | O período entre as tentativas de realizar verificações de integridade, se o aplicativo ou o cluster não estiver íntegro. |
| --estabilidade de verificação de integridade | A quantidade de tempo que o aplicativo ou o cluster deve permanecer íntegro antes que a atualização passe para o próximo domínio de atualização. Primeiro, é interpretado como uma cadeia de caracteres representando uma duração ISO 8601. Se isso falhar, será interpretado como um número que representa o número total de milissegundos. |
| --espera de verificação de integridade | O período de espera após a conclusão de um domínio de atualização, antes de iniciar o processo de verificações de integridade. |
| --verificação do conjunto de réplicas | A quantidade máxima de tempo para bloqueio do processamento de um domínio de atualização e prevenção da perda de disponibilidade quando houver problemas inesperados. Quando esse tempo limite expira, o processamento do domínio de atualização continua, independentemente de problemas de perda de disponibilidade. O tempo limite será redefinido no início de cada domínio de atualização. Os valores válidos estão entre 0 e 42949672925, inclusive. |
| --mapa de integridade do tipo de svc | Lista codificada JSON de objetos que descrevem as políticas de integridade usadas para avaliar a integridade de diferentes tipos de serviços. |
| --timeout -t | Padrão: 60. |
| --aplicativo prejudicial | O percentual máximo permitido de aplicativos não íntegros antes de relatar um erro. Por exemplo, para permitir que 10% dos aplicativos sejam problemáticos, esse valor seria 10. A porcentagem representa o máximo tolerado de aplicativos que podem estar não íntegros antes de o cluster ser considerado com erro. Se a porcentagem for respeitada, mas houver pelo menos um aplicativo não íntegro, a integridade será avaliada como ‘Aviso’. Isso é calculado dividindo o número de aplicativos problemáticos no número total de instâncias de aplicativos no cluster. |
| -tempo limite ao domínio de upgrade | A quantidade de tempo que cada domínio de atualização deve concluir antes de FailureAction ser executado. Primeiro, é interpretado como uma cadeia de caracteres representando uma duração ISO 8601. Se isso falhar, será interpretado como um número que representa o número total de milissegundos. |
| --tipo de upgrade | Padrão: sem interrupção. |
| --modo de upgrade | Os valores possíveis incluem: 'Invalid', 'UnmonitoredAuto', 'UnmonitoredManual', 'Monitored'. Padrão: UnmonitoredAuto. |
| -tempo limite de upgrade | A quantidade de tempo que a atualização geral deve concluir antes de FailureAction ser executado. Primeiro, é interpretado como uma cadeia de caracteres representando uma duração ISO 8601. Se isso falhar, será interpretado como um número que representa o número total de milissegundos. |
| --user | Nome de usuário para conectar o registro de contêiner. |
| --aviso-como-erro | Indica se os avisos são ou não tratados com a mesma severidade que os erros. |
Argumentos globais
| Argumento | Descrição |
|---|---|
| --debug | Aumente o detalhamento do log para mostrar todos os logs de depuração. |
| --help -h | Mostrar esta mensagem de ajuda e sair. |
| --output -o | Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json. |
| --query | Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos. |
| --verbose | Aumentar o detalhamento do log. Use --debug para logs de depuração completos. |
Reversão de atualização de composição de sfctl
Começa a reversão de uma atualização de implantação de composição no cluster do Service Fabric.
Reversão de uma atualização de implantação de composição do Service Fabric.
Argumentos
| Argument | Descrição |
|---|---|
| --nome de implantação [obrigatório] | A identidade da implantação. |
| --timeout -t | Tempo limite do servidor para executar a operação em segundos. Especifica o tempo que o cliente está disposto a esperar para que operação solicitada seja concluída. O valor padrão desse parâmetro é 60 segundos. Padrão: 60. |
Argumentos globais
| Argumento | Descrição |
|---|---|
| --debug | Aumente o detalhamento do log para mostrar todos os logs de depuração. |
| --help -h | Mostrar esta mensagem de ajuda e sair. |
| --output -o | Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json. |
| --query | Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos. |
| --verbose | Aumentar o detalhamento do log. Use --debug para logs de depuração completos. |
sfctl compor o status de atualização
Obtém detalhes para a atualização mais recente realizada na implantação da composição do Service Fabric.
Retorna as informações sobre o estado da atualização de implantação de redação juntamente com detalhes para auxiliar na depuração problemas de integridade do aplicativo.
Argumentos
| Argument | Descrição |
|---|---|
| --nome de implantação [obrigatório] | A identidade da implantação. |
| --timeout -t | Tempo limite do servidor para executar a operação em segundos. Especifica o tempo que o cliente está disposto a esperar para que operação solicitada seja concluída. O valor padrão desse parâmetro é 60 segundos. Padrão: 60. |
Argumentos globais
| Argumento | Descrição |
|---|---|
| --debug | Aumente o detalhamento do log para mostrar todos os logs de depuração. |
| --help -h | Mostrar esta mensagem de ajuda e sair. |
| --output -o | Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json. |
| --query | Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos. |
| --verbose | Aumentar o detalhamento do log. Use --debug para logs de depuração completos. |
Próximas etapas
- Configurar a CLI do Service Fabric.
- Saiba como usar a CLI do Service Fabric usando os scripts de exemplo.