aplicación de sfctl

Crear, eliminar y administrar aplicaciones y tipos de aplicación.

Commands

Comando Descripción
create Crea una aplicación de Service Fabric con la descripción especificada.
delete Elimina una aplicación de Service Fabric existente.
desplegado Obtiene la información sobre una aplicación implementada en un nodo de Service Fabric.
estado implementado Obtiene la información sobre el estado de una aplicación implementada en un nodo de Service Fabric.
lista implementada Obtiene la lista de aplicaciones implementadas en un nodo de Service Fabric.
health Obtiene el estado de la aplicación de Service Fabric.
Información Obtiene información sobre una aplicación de Service Fabric.
lista Obtiene la lista de aplicaciones creadas en el clúster de Service Fabric que coinciden con los filtros especificados.
carga Obtiene información de carga sobre una aplicación de Service Fabric.
manifiesto Obtiene el manifiesto que describe un tipo de aplicación.
Provisión Aprovisiona o registra un tipo de aplicación de Service Fabric con el clúster mediante el paquete ".sfpkg" en el almacén externo o mediante el paquete de aplicación en el almacén de imágenes.
report-health Envía un informe de estado en la aplicación de Service Fabric.
tipo Obtiene la lista de tipos de aplicación del clúster de Service Fabric que coinciden exactamente con el nombre especificado.
type-list Obtiene la lista de tipos de aplicación en el clúster de Service Fabric.
desaprovisionar Quita o anula el registro de un tipo de aplicación de Service Fabric del clúster.
upgrade Inicia la actualización de una aplicación en el clúster de Service Fabric.
upgrade-resume Reanuda la actualización de una aplicación en el clúster de Service Fabric.
upgrade-rollback Comienza a revertir la actualización en curso de una aplicación en el clúster de Service Fabric.
upgrade-status Obtiene los detalles de la actualización más reciente realizada en esta aplicación.
subir Copie un paquete de aplicación de Service Fabric en el almacén de imágenes.

sfctl application create

Crea una aplicación de Service Fabric con la descripción especificada.

Argumentos

Argumento Descripción
--app-name [Obligatorio] El nombre de la aplicación, incluido el esquema de URI 'fabric:'.
--app-type [Obligatorio] Nombre del tipo de aplicación que se encuentra en el manifiesto de aplicación.
--app-version [Obligatorio] Versión del tipo de aplicación tal como se define en el manifiesto de aplicación.
--max-node-count Número máximo de nodos en los que Service Fabric reserva capacidad para esta aplicación. Esto no significa que los servicios de esta aplicación se coloquen en todos esos nodos.
--metrics Lista con codificación JSON de descripciones de métricas de capacidad de aplicación. Una métrica se define como un nombre, asociada a un conjunto de capacidades para cada nodo en el que existe la aplicación.
--min-node-count Número mínimo de nodos en los que Service Fabric reserva capacidad para esta aplicación. Esto no significa que los servicios de esta aplicación se colocarán en todos esos nodos.
--parameters Lista con codificación JSON de invalidaciones de parámetros de aplicación que se aplicarán al crear la aplicación.
--timeout -t Valor predeterminado: 60.

Argumentos globales

Argumento Descripción
--debug Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
--help -h Mostrar este mensaje de ayuda y salir.
--output -o Formato de salida. Valores permitidos: json, jsonc, table y tsv. Valor predeterminado: json.
--query Cadena de consulta JMESPath. Para obtener más información y ejemplos, vea https://jmespath.org/.
--verbose Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

sfctl application delete

Elimina una aplicación de Service Fabric existente.

Se debe crear una aplicación para poder eliminarla. Al eliminar una aplicación, se eliminan todos los servicios que forman parte de esa aplicación. De forma predeterminada, Service Fabric intenta cerrar las réplicas de servicio de forma correcta y, a continuación, eliminar el servicio. Sin embargo, si un servicio tiene problemas para cerrar la réplica correctamente, la operación de eliminación puede tardar mucho tiempo o bloquearse. Use la marca ForceRemove opcional para omitir la secuencia de cierre correcta y eliminar forzadamente la aplicación y todos sus servicios.

Argumentos

Argumento Descripción
--application-id [Obligatorio] Identidad de la aplicación. Normalmente es el nombre completo de la aplicación sin el esquema de URI "fabric:". A partir de la versión 6.0, los nombres jerárquicos se delimitan con el carácter "~". Por ejemplo, si el nombre de la aplicación es "fabric:/myapp/app1", la identidad de la aplicación sería "myapp~app1" en 6.0+ y "myapp/app1" en versiones anteriores.
--force-remove Quite una aplicación o un servicio de Service Fabric de forma forzada sin pasar por la secuencia de apagado correcta. Este parámetro se puede usar para eliminar de forma forzada una aplicación o un servicio para los que la eliminación agota el tiempo de espera debido a problemas en el código de servicio que impide el cierre correcto de las réplicas.
--timeout -t El tiempo límite del servidor para realizar la operación en segundos. Este tiempo de espera especifica el tiempo que el cliente está dispuesto a esperar para que se complete la operación solicitada. El valor por defecto de este parámetro es 60 segundos. Valor predeterminado: 60.

Argumentos globales

Argumento Descripción
--debug Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
--help -h Mostrar este mensaje de ayuda y salir.
--output -o Formato de salida. Valores permitidos: json, jsonc, table y tsv. Valor predeterminado: json.
--query Cadena de consulta JMESPath. Para obtener más información y ejemplos, vea https://jmespath.org/.
--verbose Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

aplicación sfctl implementada

Obtiene la información sobre una aplicación implementada en un nodo de Service Fabric.

Esta consulta devuelve información de la aplicación del sistema si el identificador de aplicación proporcionado es para la aplicación del sistema. Los resultados abarcan aplicaciones implementadas en estados activos, activados y descargados. Esta consulta requiere que el nombre del nodo corresponda a un nodo del clúster. Se produce un error en la consulta si el nombre del nodo proporcionado no apunta a ningún nodo activo de Service Fabric en el clúster.

Argumentos

Argumento Descripción
--application-id [Obligatorio] Identidad de la aplicación. Normalmente es el nombre completo de la aplicación sin el esquema de URI "fabric:". A partir de la versión 6.0, los nombres jerárquicos se delimitan con el carácter "~". Por ejemplo, si el nombre de la aplicación es "fabric:/myapp/app1", la identidad de la aplicación sería "myapp~app1" en 6.0+ y "myapp/app1" en versiones anteriores.
--node-name [Obligatorio] El nombre del nodo.
--include-health-state Incluya el estado de mantenimiento de una entidad. Si este parámetro es false o no se especifica, el estado de mantenimiento devuelto es "Unknown". Cuando se establece en true, la consulta pasa en paralelo al nodo y al servicio del sistema de mantenimiento antes de combinar los resultados. Como resultado, la consulta es más costosa y puede tardar más tiempo.
--timeout -t El tiempo límite del servidor para realizar la operación en segundos. Este tiempo de espera especifica el tiempo que el cliente está dispuesto a esperar para que se complete la operación solicitada. El valor por defecto de este parámetro es 60 segundos. Valor predeterminado: 60.

Argumentos globales

Argumento Descripción
--debug Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
--help -h Mostrar este mensaje de ayuda y salir.
--output -o Formato de salida. Valores permitidos: json, jsonc, table y tsv. Valor predeterminado: json.
--query Cadena de consulta JMESPath. Para obtener más información y ejemplos, vea https://jmespath.org/.
--verbose Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

sfctl application deployed-health

Obtiene la información sobre el estado de una aplicación implementada en un nodo de Service Fabric.

Obtiene la información sobre el estado de una aplicación implementada en un nodo de Service Fabric. Use EventsHealthStateFilter para filtrar opcionalmente la colección de objetos HealthEvent notificados en la aplicación implementada en función del estado de mantenimiento. Use DeployedServicePackagesHealthStateFilter para filtrar opcionalmente los elementos secundarios DeployedServicePackageHealth en función del estado de mantenimiento.

Argumentos

Argumento Descripción
--application-id [Obligatorio] Identidad de la aplicación. Normalmente es el nombre completo de la aplicación sin el esquema de URI "fabric:". A partir de la versión 6.0, los nombres jerárquicos se delimitan con el carácter "~". Por ejemplo, si el nombre de la aplicación es "fabric:/myapp/app1", la identidad de la aplicación sería "myapp~app1" en 6.0+ y "myapp/app1" en versiones anteriores.
--node-name [Obligatorio] El nombre del nodo.
--deployed-service-packages-health-state-filter Permite el filtrado de los objetos de estado de mantenimiento del paquete de servicio implementados devueltos en el resultado de la consulta de estado de la aplicación implementada en función de su estado de mantenimiento. Los valores posibles para este parámetro incluyen el valor entero de uno de los siguientes estados de mantenimiento. Solo se devuelven los paquetes de servicio implementados que coincidan con el filtro. Todos los paquetes de servicio implementados se usan para evaluar el estado de mantenimiento agregado de la aplicación implementada. Si no se especifica, se devuelven todas las entradas. Los valores de estado son enumeración basada en marcas, por lo que el valor puede ser una combinación de estos valores, obtenido mediante el operador bit a bit 'OR'. Por ejemplo, si el valor proporcionado es 6, se devuelve el estado de mantenimiento de los paquetes de servicio con el valor HealthState de OK (2) y Warning (4).
- Valor predeterminado: valor predeterminado. Coincide con cualquier HealthState. El valor es cero.
- None: filtro que no coincide con ningún valor healthState. Se usa para no devolver ningún resultado en una colección determinada de estados. El valor es 1.
- Ok: filtro que coincide con la entrada con el valor HealthState Ok. El valor es 2.
- Advertencia: filtro que coincide con la entrada con el valor HealthState Advertencia. El valor es 4.
- Error: filtro que coincide con la entrada con el valor HealthState Error. El valor es 8.
- All: filtro que coincide con la entrada con cualquier valor healthState. El valor es 65535.
--events-health-state-filter Permite filtrar la colección de objetos HealthEvent devueltos en función del estado de mantenimiento. Los valores posibles para este parámetro incluyen el valor entero de uno de los siguientes estados de mantenimiento. Solo se devuelven los eventos que coinciden con el filtro. Todos los eventos se usan para evaluar el estado de mantenimiento agregado. Si no se especifica, se devuelven todas las entradas. Los valores de estado son enumeración basada en marcas, por lo que el valor podría ser una combinación de estos valores, obtenido mediante el operador bit a bit 'OR'. Por ejemplo, si el valor proporcionado es 6, se devuelven todos los eventos con el valor HealthState de OK (2) y Warning (4).
- Valor predeterminado: valor predeterminado. Coincide con cualquier HealthState. El valor es cero.
- None: filtro que no coincide con ningún valor healthState. Se usa para no devolver ningún resultado en una colección determinada de estados. El valor es 1.
- Ok: filtro que coincide con la entrada con el valor HealthState Ok. El valor es 2.
- Advertencia: filtro que coincide con la entrada con el valor HealthState Advertencia. El valor es 4.
- Error: filtro que coincide con la entrada con el valor HealthState Error. El valor es 8.
- All: filtro que coincide con la entrada con cualquier valor healthState. El valor es 65535.
--exclude-health-statistics Indica si las estadísticas de salud deben devolverse como parte del resultado de la consulta. False de forma predeterminada. Las estadísticas muestran el número de niños en estado de salud Ok, Warning y Error.
--timeout -t El tiempo límite del servidor para realizar la operación en segundos. Este tiempo de espera especifica el tiempo que el cliente está dispuesto a esperar para que se complete la operación solicitada. El valor por defecto de este parámetro es 60 segundos. Valor predeterminado: 60.

Argumentos globales

Argumento Descripción
--debug Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
--help -h Mostrar este mensaje de ayuda y salir.
--output -o Formato de salida. Valores permitidos: json, jsonc, table y tsv. Valor predeterminado: json.
--query Cadena de consulta JMESPath. Para obtener más información y ejemplos, vea https://jmespath.org/.
--verbose Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

sfctl application deployed-list

Obtiene la lista de aplicaciones implementadas en un nodo de Service Fabric.

Obtiene la lista de aplicaciones implementadas en un nodo de Service Fabric. Los resultados no incluyen información sobre las aplicaciones del sistema implementadas a menos que se consulte explícitamente por identificador. Los resultados abarcan aplicaciones implementadas en estados activos, activados y descargados. Esta consulta requiere que el nombre del nodo corresponda a un nodo del clúster. Se produce un error en la consulta si el nombre del nodo proporcionado no apunta a ningún nodo activo de Service Fabric en el clúster.

Argumentos

Argumento Descripción
--node-name [Obligatorio] El nombre del nodo.
--continuation-token El parámetro de token de continuación se usa para obtener el siguiente conjunto de resultados. Un token de continuación con un valor no desempty se incluye en la respuesta de la API cuando los resultados del sistema no caben en una única respuesta. Cuando este valor se pasa a la siguiente llamada API, la API devuelve el siguiente conjunto de resultados. Si no hay ningún resultado adicional, el token de continuación no contiene un valor. El valor de este parámetro no debe estar codificado en dirección URL.
--include-health-state Incluya el estado de mantenimiento de una entidad. Si este parámetro es false o no se especifica, el estado de mantenimiento devuelto es "Unknown". Cuando se establece en true, la consulta pasa en paralelo al nodo y al servicio del sistema de mantenimiento antes de combinar los resultados. Como resultado, la consulta es más costosa y puede tardar más tiempo.
--max-results Número máximo de resultados que se devolverán como parte de las consultas paginadas. Este parámetro define el límite superior en el número de resultados devueltos. Los resultados devueltos pueden ser menores que los resultados máximos especificados si no caben en el mensaje según las restricciones de tamaño máximo de mensaje definidas en la configuración. Si este parámetro es cero o no se especifica, la consulta paginada incluye tantos resultados como sea posible que se ajusten al mensaje devuelto.
--timeout -t El tiempo límite del servidor para realizar la operación en segundos. Este tiempo de espera especifica el tiempo que el cliente está dispuesto a esperar para que se complete la operación solicitada. El valor por defecto de este parámetro es 60 segundos. Valor predeterminado: 60.

Argumentos globales

Argumento Descripción
--debug Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
--help -h Mostrar este mensaje de ayuda y salir.
--output -o Formato de salida. Valores permitidos: json, jsonc, table y tsv. Valor predeterminado: json.
--query Cadena de consulta JMESPath. Para obtener más información y ejemplos, vea https://jmespath.org/.
--verbose Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

sfctl application health

Obtiene el estado de la aplicación de Service Fabric.

Devuelve el estado de calor de la aplicación de Service Fabric. La respuesta notifica el estado correcto, error o estado de mantenimiento de advertencia. Si la entidad no se encuentra en el almacén de estado, devuelve Error.

Argumentos

Argumento Descripción
--application-id [Obligatorio] Identidad de la aplicación. Normalmente es el nombre completo de la aplicación sin el esquema de URI "fabric:". A partir de la versión 6.0, los nombres jerárquicos se delimitan con el carácter "~". Por ejemplo, si el nombre de la aplicación es "fabric:/myapp/app1", la identidad de la aplicación sería "myapp~app1" en 6.0+ y "myapp/app1" en versiones anteriores.
--deployed-applications-health-state-filter Permite filtrar los objetos de estado de salud de las aplicaciones desplegadas devueltos en el resultado de la consulta de salud de la aplicación según su estado de salud. Los valores posibles para este parámetro incluyen el valor entero de uno de los siguientes estados de mantenimiento. Solo se devuelven las aplicaciones implementadas que coincidan con el filtro. Todas las aplicaciones implementadas se usan para evaluar el estado de mantenimiento agregado. Si no se especifica, se devuelven todas las entradas. Los valores de estado son enumeración basada en marcas, por lo que el valor podría ser una combinación de estos valores, obtenido mediante el operador "OR" bit a bit. Por ejemplo, si el valor proporcionado es 6, se devuelve el estado de mantenimiento de las aplicaciones implementadas con el valor HealthState de OK (2) y Warning (4).
- Valor predeterminado: valor predeterminado. Coincide con cualquier HealthState. El valor es cero.
- None: filtro que no coincide con ningún valor healthState. Se usa para no devolver ningún resultado en una colección determinada de estados. El valor es 1.
- Ok: filtro que coincide con la entrada con el valor HealthState Ok. El valor es 2.
- Advertencia: filtro que coincide con la entrada con el valor HealthState Advertencia. El valor es 4.
- Error: filtro que coincide con la entrada con el valor HealthState Error. El valor es 8.
- All: filtro que coincide con la entrada con cualquier valor healthState. El valor es 65535.
--events-health-state-filter Permite filtrar la colección de objetos HealthEvent devueltos en función del estado de mantenimiento. Los valores posibles para este parámetro incluyen el valor entero de uno de los siguientes estados de mantenimiento. Solo se devuelven los eventos que coinciden con el filtro. Todos los eventos se usan para evaluar el estado de mantenimiento agregado. Si no se especifica, se devuelven todas las entradas. Los valores de estado son enumeración basada en marcas, por lo que el valor podría ser una combinación de estos valores, obtenido mediante el operador bit a bit 'OR'. Por ejemplo, si el valor proporcionado es 6, se devuelven todos los eventos con el valor HealthState de OK (2) y Warning (4).
- Valor predeterminado: valor predeterminado. Coincide con cualquier HealthState. El valor es cero.
- None: filtro que no coincide con ningún valor healthState. Se usa para no devolver ningún resultado en una colección determinada de estados. El valor es 1.
- Ok: filtro que coincide con la entrada con el valor HealthState Ok. El valor es 2.
- Advertencia: filtro que coincide con la entrada con el valor HealthState Advertencia. El valor es 4.
- Error: filtro que coincide con la entrada con el valor HealthState Error. El valor es 8.
- All: filtro que coincide con la entrada con cualquier valor healthState. El valor es 65535.
--exclude-health-statistics Indica si las estadísticas de salud deben devolverse como parte del resultado de la consulta. False de forma predeterminada. Las estadísticas muestran el número de niños en estado de salud Ok, Warning y Error.
--services-health-state-filter Permite filtrar los objetos de estado de salud de los servicios devueltos en el resultado de la consulta de salud de servicios según su estado de salud. Los valores posibles para este parámetro incluyen el valor entero de uno de los siguientes estados de mantenimiento. Solo se devuelven los servicios que coinciden con el filtro. Todos los servicios se usan para evaluar el estado de mantenimiento agregado. Si no se especifica, se devuelven todas las entradas. Los valores de estado son enumeración basada en marcas, por lo que el valor podría ser una combinación de estos valores, obtenido mediante el operador "OR" bit a bit. Por ejemplo, si el valor proporcionado es 6, se devolverá el estado de mantenimiento de los servicios con el valor HealthState de OK (2) y Warning (4).
- Valor predeterminado: valor predeterminado. Coincide con cualquier HealthState. El valor es cero.
- None: filtro que no coincide con ningún valor healthState. Se usa para no devolver ningún resultado en una colección determinada de estados. El valor es 1.
- Ok: filtro que coincide con la entrada con el valor HealthState Ok. El valor es 2.
- Advertencia: filtro que coincide con la entrada con el valor HealthState Advertencia. El valor es 4.
- Error: filtro que coincide con la entrada con el valor HealthState Error. El valor es 8.
- All: filtro que coincide con la entrada con cualquier valor healthState. El valor es 65535.
--timeout -t El tiempo límite del servidor para realizar la operación en segundos. Este tiempo de espera especifica el tiempo que el cliente está dispuesto a esperar para que se complete la operación solicitada. El valor por defecto de este parámetro es 60 segundos. Valor predeterminado: 60.

Argumentos globales

Argumento Descripción
--debug Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
--help -h Mostrar este mensaje de ayuda y salir.
--output -o Formato de salida. Valores permitidos: json, jsonc, table y tsv. Valor predeterminado: json.
--query Cadena de consulta JMESPath. Para obtener más información y ejemplos, vea https://jmespath.org/.
--verbose Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

información de la aplicación sfctl

Obtiene información sobre una aplicación de Service Fabric.

Devuelve la información sobre la aplicación que se creó o en el proceso de creación en el clúster de Service Fabric y cuyo nombre coincide con el especificado como parámetro. La respuesta incluye el nombre, el tipo, el estado, los parámetros y otros detalles sobre la aplicación.

Argumentos

Argumento Descripción
--application-id [Obligatorio] Identidad de la aplicación. Normalmente es el nombre completo de la aplicación sin el esquema de URI "fabric:". A partir de la versión 6.0, los nombres jerárquicos se delimitan con el carácter "~". Por ejemplo, si el nombre de la aplicación es "fabric:/myapp/app1", la identidad de la aplicación sería "myapp~app1" en 6.0+ y "myapp/app1" en versiones anteriores.
--exclude-application-parameters Marca que especifica si los parámetros de aplicación se excluyen del resultado.
--timeout -t El tiempo límite del servidor para realizar la operación en segundos. Este tiempo de espera especifica el tiempo que el cliente está dispuesto a esperar para que se complete la operación solicitada. El valor por defecto de este parámetro es 60 segundos. Valor predeterminado: 60.

Argumentos globales

Argumento Descripción
--debug Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
--help -h Mostrar este mensaje de ayuda y salir.
--output -o Formato de salida. Valores permitidos: json, jsonc, table y tsv. Valor predeterminado: json.
--query Cadena de consulta JMESPath. Para obtener más información y ejemplos, vea https://jmespath.org/.
--verbose Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

sfctl application list

Obtiene la lista de aplicaciones creadas en el clúster de Service Fabric que coinciden con los filtros especificados.

Obtiene la información sobre las aplicaciones que se crearon o en el proceso de creación en el clúster de Service Fabric y coinciden con los filtros especificados. La respuesta incluye el nombre, el tipo, el estado, los parámetros y otros detalles sobre la aplicación. Si las aplicaciones no caben en una página, se devuelve una página de resultados, así como un token de continuación, que se puede usar para obtener la página siguiente. Los filtros ApplicationTypeName y ApplicationDefinitionKindFilter no se pueden especificar al mismo tiempo.

Argumentos

Argumento Descripción
--application-definition-kind-filter Se usa para filtrar por ApplicationDefinitionKind, que es el mecanismo que se usa para definir una aplicación de Service Fabric.
- Valor predeterminado: valor predeterminado, que realiza la misma función que la selección de "Todo". El valor es 0.
- All: filtro que coincide con la entrada con cualquier valor ApplicationDefinitionKind. El valor es 65535.
- ServiceFabricApplicationDescription: filtro que coincide con la entrada con el valor applicationDefinitionKind ServiceFabricApplicationDescription. El valor es 1.
- Compose: filtro que coincide con la entrada con el valor ApplicationDefinitionKind Compose. El valor es 2.
--application-type-name Nombre del tipo de aplicación que se usa para filtrar las aplicaciones para las que se van a consultar. Este valor no debe contener la versión del tipo de aplicación.
--continuation-token El parámetro de token de continuación se usa para obtener el siguiente conjunto de resultados. Un token de continuación con un valor no desempty se incluye en la respuesta de la API cuando los resultados del sistema no caben en una única respuesta. Cuando este valor se pasa a la siguiente llamada API, la API devuelve el siguiente conjunto de resultados. Si no hay ningún resultado adicional, el token de continuación no contiene un valor. El valor de este parámetro no debe estar codificado en dirección URL.
--exclude-application-parameters Marca que especifica si los parámetros de aplicación se excluyen del resultado.
--max-results Número máximo de resultados que se devolverán como parte de las consultas paginadas. Este parámetro define el límite superior en el número de resultados devueltos. Los resultados devueltos pueden ser menores que los resultados máximos especificados si no caben en el mensaje según las restricciones de tamaño máximo de mensaje definidas en la configuración. Si este parámetro es cero o no se especifica, la consulta paginada incluye tantos resultados como sea posible que se ajusten al mensaje devuelto.
--timeout -t El tiempo límite del servidor para realizar la operación en segundos. Este tiempo de espera especifica el tiempo que el cliente está dispuesto a esperar para que se complete la operación solicitada. El valor por defecto de este parámetro es 60 segundos. Valor predeterminado: 60.

Argumentos globales

Argumento Descripción
--debug Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
--help -h Mostrar este mensaje de ayuda y salir.
--output -o Formato de salida. Valores permitidos: json, jsonc, table y tsv. Valor predeterminado: json.
--query Cadena de consulta JMESPath. Para obtener más información y ejemplos, vea https://jmespath.org/.
--verbose Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

carga de la aplicación sfctl

Obtiene información de carga sobre una aplicación de Service Fabric.

Devuelve la información de carga sobre la aplicación que se creó o en el proceso de creación en el clúster de Service Fabric y cuyo nombre coincide con el especificado como parámetro. La respuesta incluye el nombre, los nodos mínimos, los nodos máximos, el número de nodos que ocupa la aplicación actualmente y la información de métrica de carga de la aplicación sobre la aplicación.

Argumentos

Argumento Descripción
--application-id [Obligatorio] Identidad de la aplicación. Normalmente es el nombre completo de la aplicación sin el esquema de URI "fabric:". A partir de la versión 6.0, los nombres jerárquicos se delimitan con el carácter "~". Por ejemplo, si el nombre de la aplicación es "fabric:/myapp/app1", la identidad de la aplicación sería "myapp~app1" en 6.0+ y "myapp/app1" en versiones anteriores.
--timeout -t El tiempo límite del servidor para realizar la operación en segundos. Este tiempo de espera especifica el tiempo que el cliente está dispuesto a esperar para que se complete la operación solicitada. El valor por defecto de este parámetro es 60 segundos. Valor predeterminado: 60.

Argumentos globales

Argumento Descripción
--debug Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
--help -h Mostrar este mensaje de ayuda y salir.
--output -o Formato de salida. Valores permitidos: json, jsonc, table y tsv. Valor predeterminado: json.
--query Cadena de consulta JMESPath. Para obtener más información y ejemplos, vea https://jmespath.org/.
--verbose Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

sfctl application manifest

Obtiene el manifiesto que describe un tipo de aplicación.

La respuesta contiene el XML del manifiesto de aplicación como una cadena.

Argumentos

Argumento Descripción
--application-type-name [Obligatorio] Nombre del tipo de aplicación.
--application-type-version [Obligatorio] Versión del tipo de aplicación.
--timeout -t El tiempo límite del servidor para realizar la operación en segundos. Este tiempo de espera especifica el tiempo que el cliente está dispuesto a esperar para que se complete la operación solicitada. El valor por defecto de este parámetro es 60 segundos. Valor predeterminado: 60.

Argumentos globales

Argumento Descripción
--debug Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
--help -h Mostrar este mensaje de ayuda y salir.
--output -o Formato de salida. Valores permitidos: json, jsonc, table y tsv. Valor predeterminado: json.
--query Cadena de consulta JMESPath. Para obtener más información y ejemplos, vea https://jmespath.org/.
--verbose Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

sfctl application provision

Aprovisiona o registra un tipo de aplicación de Service Fabric con el clúster mediante el paquete ".sfpkg" en el almacén externo o mediante el paquete de aplicación en el almacén de imágenes.

Aprovisiona un tipo de aplicación de Service Fabric con el clúster. El aprovisionamiento es necesario para poder crear instancias de las nuevas aplicaciones. La operación de aprovisionamiento se puede realizar en el paquete de aplicación especificado por relativePathInImageStore o mediante el URI del archivo externo '.sfpkg'. A menos que se establezca --external-provision, este comando espera el aprovisionamiento del almacén de imágenes.

Argumentos

Argumento Descripción
--application-package-download-uri Ruta de acceso al paquete de aplicación '.sfpkg' desde donde se puede descargar el paquete de aplicación mediante protocolos HTTP o HTTPS.

Solo para el almacén externo de tipo de aprovisionamiento. El paquete de aplicación se puede almacenar en un almacén externo que proporciona la operación GET para descargar el archivo. Los protocolos admitidos son HTTP y HTTPS, y la ruta de acceso debe permitir el acceso READ.
--application-type-build-path Solo para el almacén de imágenes de tipo de aprovisionamiento. Ruta de acceso relativa del paquete de aplicación en el almacén de imágenes especificado durante la operación de carga anterior.
--application-type-name Solo para el almacén externo de tipo de aprovisionamiento. El nombre del tipo de aplicación representa el nombre del tipo de aplicación que se encuentra en el manifiesto de aplicación.
--application-type-version Solo para el almacén externo de tipo de aprovisionamiento. La versión del tipo de aplicación representa la versión del tipo de aplicación que se encuentra en el manifiesto de aplicación.
--external-provision Ubicación desde donde se puede registrar o aprovisionar el paquete de aplicación. Indica que el aprovisionamiento es para un paquete de aplicación que se cargó anteriormente en un almacén externo. El paquete de aplicación termina con la extensión *.sfpkg.
--no-wait Indica si el aprovisionamiento debe producirse de forma asincrónica.

Cuando se establece en true, la operación de aprovisionamiento devuelve cuando el sistema acepta la solicitud y la operación de aprovisionamiento continúa sin ningún límite de tiempo de espera. El valor predeterminado es false. Para paquetes de aplicaciones de gran tamaño, se recomienda establecer el valor en true.
--timeout -t Valor predeterminado: 60.

Argumentos globales

Argumento Descripción
--debug Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
--help -h Mostrar este mensaje de ayuda y salir.
--output -o Formato de salida. Valores permitidos: json, jsonc, table y tsv. Valor predeterminado: json.
--query Cadena de consulta JMESPath. Para obtener más información y ejemplos, vea https://jmespath.org/.
--verbose Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

sfctl application report-health

Envía un informe de estado en la aplicación de Service Fabric.

Informa del estado de mantenimiento de la aplicación de Service Fabric especificada. El informe debe contener la información sobre el origen del informe de mantenimiento y la propiedad en el que se notifica. El informe se envía a una aplicación de puerta de enlace de Service Fabric, que se reenvía al almacén de estado. La puerta de enlace puede aceptar el informe, pero el almacén de estado puede rechazarlo después de una validación adicional. Por ejemplo, el almacén de estado puede rechazar el informe debido a un parámetro no válido, como un número de secuencia obsoleto. Para ver si el informe se aplicó en el almacén de estado, obtenga el estado de la aplicación y compruebe que aparece el informe.

Argumentos

Argumento Descripción
--application-id [Obligatorio] Identidad de la aplicación.

Normalmente es el nombre completo de la aplicación sin el esquema de URI "fabric:". A partir de la versión 6.0, los nombres jerárquicos se delimitan con el carácter "~". Por ejemplo, si el nombre de la aplicación es "fabric:/myapp/app1", la identidad de la aplicación sería "myapp~app1" en 6.0+ y "myapp/app1" en versiones anteriores.
--health-property [Obligatorio] Propiedad de la información de mantenimiento.

Una entidad puede tener informes de estado para propiedades diferentes. La propiedad es una cadena y no una enumeración fija para permitir que la flexibilidad del informador clasifique la condición de estado que desencadena el informe. Por ejemplo, un periodista con SourceId "LocalWatchdog" puede supervisar el estado del disco disponible en un nodo, por lo que puede notificar la propiedad "AvailableDisk" en ese nodo. El mismo periodista puede supervisar la conectividad del nodo, por lo que puede notificar una propiedad "Connectivity" en el mismo nodo. En el almacén de estado, estos informes se tratan como eventos de mantenimiento independientes para el nodo especificado. Junto con SourceId, la propiedad identifica de forma única la información de mantenimiento.
--health-state [Obligatorio] Entre los valores posibles se incluyen: 'Invalid', 'Ok', 'Warning', 'Error', 'Unknown'.
--source-id [Obligatorio] Nombre de origen que identifica el componente client/watchdog/system que generó la información de mantenimiento.
--description Descripción de la información de mantenimiento.

Representa texto libre usado para agregar información legible sobre el informe. La longitud máxima de cadena de la descripción es de 4096 caracteres. Si la cadena proporcionada es más larga, se trunca automáticamente. Cuando se trunca, los últimos caracteres de la descripción contienen un marcador "[Truncado]" y el tamaño total de la cadena es de 4096 caracteres. La presencia del marcador indica a los usuarios que se han producido el truncamiento. Cuando se trunca, la descripción tiene menos de 4096 caracteres de la cadena original.
--immediate Marca que indica si el informe debe enviarse inmediatamente.

Un informe de estado se envía a una aplicación de puerta de enlace de Service Fabric, que se reenvía al almacén de estado. Si Immediate se establece en true, el informe se envía inmediatamente desde la puerta de enlace HTTP al almacén de estado, independientemente de la configuración del cliente de tejido que use la aplicación de puerta de enlace HTTP. Esto resulta útil para informes críticos que se deben enviar lo antes posible. Según el tiempo y otras condiciones, es posible que el envío del informe siga produciendo un error, por ejemplo, si la puerta de enlace HTTP está cerrada o el mensaje no llega a la puerta de enlace. Si Immediate se establece en false, el informe se envía en función de la configuración del cliente de mantenimiento de la puerta de enlace HTTP. Por lo tanto, se realiza por lotes según la configuración healthReportSendInterval. Esta es la configuración recomendada porque permite al cliente de mantenimiento optimizar los mensajes de informes de mantenimiento en el almacén de estado, así como el procesamiento de informes de estado. De forma predeterminada, los informes no se envían inmediatamente.
--remove-when-expired Valor que indica si el informe se quita del almacén de estado cuando expira.

Si se establece en true, el informe se quita del almacén de estado después de que expire. Si se establece en false, el informe se trata como un error cuando ha expirado. El valor de esta propiedad es false de forma predeterminada. Cuando los clientes informan periódicamente, deben establecer RemoveWhenExpired false (valor predeterminado). De este modo, si el informador tiene problemas (por ejemplo, interbloqueo) y no puede informar, la entidad se evalúa en error cuando expira el informe de mantenimiento. Esto marca la entidad como si estuviera en estado de mantenimiento de errores.
--sequence-number Número de secuencia de este informe de estado como una cadena numérica.

El almacén de estado usa el número de secuencia de informes para detectar informes obsoletos. Si no se especifica, el cliente de mantenimiento genera automáticamente un número de secuencia cuando se agrega un informe.
--timeout -t Valor predeterminado: 60.
--ttl Duración para la que este informe de mantenimiento es válido. Este campo usa ISO8601 formato para especificar la duración.

Cuando los clientes informan periódicamente, deben enviar informes con mayor frecuencia que el tiempo de vida. Si los clientes informan sobre la transición, pueden establecer el período de vida en infinito. Cuando expira el período de vida, el evento de mantenimiento que contiene la información de mantenimiento se quita del almacén de estado, si RemoveWhenExpired es true o se evalúa en error, si RemoveWhenExpired false. Si no se especifica, el período de vida tiene como valor predeterminado infinito.

Argumentos globales

Argumento Descripción
--debug Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
--help -h Mostrar este mensaje de ayuda y salir.
--output -o Formato de salida. Valores permitidos: json, jsonc, table y tsv. Valor predeterminado: json.
--query Cadena de consulta JMESPath. Para obtener más información y ejemplos, vea https://jmespath.org/.
--verbose Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

tipo de aplicación sfctl

Obtiene la lista de tipos de aplicación del clúster de Service Fabric que coinciden exactamente con el nombre especificado.

Devuelve la información sobre los tipos de aplicación que se aprovisionan o en el proceso de aprovisionamiento en el clúster de Service Fabric. Estos resultados son de tipos de aplicación cuyo nombre coincide exactamente con el especificado como parámetro y que cumplen los parámetros de consulta especificados. Se devuelven todas las versiones del tipo de aplicación que coinciden con el nombre del tipo de aplicación, con cada versión devuelta como un tipo de aplicación. La respuesta incluye el nombre, la versión, el estado y otros detalles sobre el tipo de aplicación. Se trata de una consulta paginada, lo que significa que, si no todos los tipos de aplicación caben en una página, se devuelve una página de resultados, así como un token de continuación, que se puede usar para obtener la página siguiente. Por ejemplo, si hay 10 tipos de aplicación, pero una página solo se ajusta a los tres primeros tipos de aplicación, o si los resultados máximos se establecen en 3, se devuelven tres. Para acceder al resto de los resultados, recupere las páginas posteriores mediante el token de continuación devuelto en la siguiente consulta. Se devuelve un token de continuación vacío si no hay páginas posteriores.

Argumentos

Argumento Descripción
--application-type-name [Obligatorio] Nombre del tipo de aplicación.
--application-type-version Versión del tipo de aplicación.
--continuation-token El parámetro de token de continuación se usa para obtener el siguiente conjunto de resultados. Un token de continuación con un valor no desempty se incluye en la respuesta de la API cuando los resultados del sistema no caben en una única respuesta. Cuando este valor se pasa a la siguiente llamada API, la API devuelve el siguiente conjunto de resultados. Si no hay ningún resultado adicional, el token de continuación no contiene un valor. El valor de este parámetro no debe estar codificado en dirección URL.
--exclude-application-parameters Marca que especifica si los parámetros de aplicación se excluyen del resultado.
--max-results Número máximo de resultados que se devolverán como parte de las consultas paginadas. Este parámetro define el límite superior en el número de resultados devueltos. Los resultados devueltos pueden ser menores que los resultados máximos especificados si no caben en el mensaje según las restricciones de tamaño máximo de mensaje definidas en la configuración. Si este parámetro es cero o no se especifica, la consulta paginada incluye tantos resultados como sea posible que se ajusten al mensaje devuelto.
--timeout -t El tiempo límite del servidor para realizar la operación en segundos. Este tiempo de espera especifica el tiempo que el cliente está dispuesto a esperar para que se complete la operación solicitada. El valor por defecto de este parámetro es 60 segundos. Valor predeterminado: 60.

Argumentos globales

Argumento Descripción
--debug Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
--help -h Mostrar este mensaje de ayuda y salir.
--output -o Formato de salida. Valores permitidos: json, jsonc, table y tsv. Valor predeterminado: json.
--query Cadena de consulta JMESPath. Para obtener más información y ejemplos, vea https://jmespath.org/.
--verbose Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

sfctl application type-list

Obtiene la lista de tipos de aplicación en el clúster de Service Fabric.

Devuelve la información sobre los tipos de aplicación que se aprovisionan o en el proceso de aprovisionamiento en el clúster de Service Fabric. Cada versión de un tipo de aplicación se devuelve como un tipo de aplicación. La respuesta incluye el nombre, la versión, el estado y otros detalles sobre el tipo de aplicación. Se trata de una consulta paginada, lo que significa que, si no todos los tipos de aplicación caben en una página, se devuelve una página de resultados, así como un token de continuación, que se puede usar para obtener la página siguiente. Por ejemplo, si hay 10 tipos de aplicación, pero una página solo se ajusta a los tres primeros tipos de aplicación, o si los resultados máximos se establecen en 3, se devuelven tres. Para acceder al resto de los resultados, recupere las páginas posteriores mediante el token de continuación devuelto en la siguiente consulta. Se devuelve un token de continuación vacío si no hay páginas posteriores.

Argumentos

Argumento Descripción
--application-type-definition-kind-filter Se usa para filtrar por ApplicationTypeDefinitionKind, que es el mecanismo que se usa para definir un tipo de aplicación de Service Fabric.
- Valor predeterminado: valor predeterminado, que realiza la misma función que la selección de "Todo". El valor es 0.
- All: filtro que coincide con la entrada con cualquier valor ApplicationTypeDefinitionKind. El valor es 65535.
- ServiceFabricApplicationPackage: filtro que coincide con la entrada con el valor ApplicationTypeDefinitionKind ServiceFabricApplicationPackage. El valor es 1.
- Compose: filtro que coincide con la entrada con el valor ApplicationTypeDefinitionKind Compose. El valor es 2.
--continuation-token El parámetro de token de continuación se usa para obtener el siguiente conjunto de resultados. Un token de continuación con un valor no desempty se incluye en la respuesta de la API cuando los resultados del sistema no caben en una única respuesta. Cuando este valor se pasa a la siguiente llamada API, la API devuelve el siguiente conjunto de resultados. Si no hay ningún resultado adicional, el token de continuación no contiene un valor. El valor de este parámetro no debe estar codificado en dirección URL.
--exclude-application-parameters Marca que especifica si los parámetros de aplicación se excluyen del resultado.
--max-results Número máximo de resultados que se devolverán como parte de las consultas paginadas. Este parámetro define el límite superior en el número de resultados devueltos. Los resultados devueltos pueden ser menores que los resultados máximos especificados si no caben en el mensaje según las restricciones de tamaño máximo de mensaje definidas en la configuración. Si este parámetro es cero o no se especifica, la consulta paginada incluye tantos resultados como sea posible que se ajusten al mensaje devuelto.
--timeout -t El tiempo límite del servidor para realizar la operación en segundos. Este tiempo de espera especifica el tiempo que el cliente está dispuesto a esperar para que se complete la operación solicitada. El valor por defecto de este parámetro es 60 segundos. Valor predeterminado: 60.

Argumentos globales

Argumento Descripción
--debug Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
--help -h Mostrar este mensaje de ayuda y salir.
--output -o Formato de salida. Valores permitidos: json, jsonc, table y tsv. Valor predeterminado: json.
--query Cadena de consulta JMESPath. Para obtener más información y ejemplos, vea https://jmespath.org/.
--verbose Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

sfctl application unprovision

Quita o anula el registro de un tipo de aplicación de Service Fabric del clúster.

Esta operación solo se puede realizar si se eliminan todas las instancias de aplicación del tipo de aplicación. Una vez que se anula el registro del tipo de aplicación, no se pueden crear nuevas instancias de aplicación para este tipo de aplicación concreto.

Argumentos

Argumento Descripción
--application-type-name [Obligatorio] Nombre del tipo de aplicación.
--application-type-version [Obligatorio] Versión del tipo de aplicación tal como se define en el manifiesto de aplicación.
--async-parameter Marca que indica si el aprovisionamiento no se debe aprovisionar de forma asincrónica. Cuando se establece en true, la operación de no aprovisionamiento devuelve cuando el sistema acepta la solicitud y la operación de desaprovisionamiento continúa sin ningún límite de tiempo de espera. El valor predeterminado es false. Sin embargo, se recomienda establecerlo en true para paquetes de aplicaciones de gran tamaño que se aprovisionaron.
--timeout -t El tiempo límite del servidor para realizar la operación en segundos. Este tiempo de espera especifica el tiempo que el cliente está dispuesto a esperar para que se complete la operación solicitada. El valor por defecto de este parámetro es 60 segundos. Valor predeterminado: 60.

Argumentos globales

Argumento Descripción
--debug Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
--help -h Mostrar este mensaje de ayuda y salir.
--output -o Formato de salida. Valores permitidos: json, jsonc, table y tsv. Valor predeterminado: json.
--query Cadena de consulta JMESPath. Para obtener más información y ejemplos, vea https://jmespath.org/.
--verbose Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

actualización de la aplicación sfctl

Inicia la actualización de una aplicación en el clúster de Service Fabric.

Valida los parámetros de actualización de aplicaciones proporcionados y comienza a actualizar la aplicación si los parámetros son válidos. La descripción de actualización reemplaza la descripción de la aplicación existente. Esto significa que, si no se especifican los parámetros, los parámetros existentes en las aplicaciones se sobrescriben con la lista de parámetros vacíos. Esto daría lugar a que la aplicación use el valor predeterminado de los parámetros del manifiesto de aplicación.

Argumentos

Argumento Descripción
--application-id [Obligatorio] Identidad de la aplicación.

Normalmente es el nombre completo de la aplicación sin el esquema de URI "fabric:". A partir de la versión 6.0, los nombres jerárquicos se delimitan con el carácter "~". Por ejemplo, si el nombre de la aplicación es "fabric:/myapp/app1", la identidad de la aplicación sería "myapp~app1" en 6.0+ y "myapp/app1" en versiones anteriores.
--application-version [Obligatorio] Versión del tipo de aplicación de destino (que se encuentra en el manifiesto de aplicación) para la actualización de la aplicación.
--parameters [Required] Lista con codificación JSON de invalidaciones de parámetros de aplicación que se aplicarán al actualizar la aplicación.
--default-service-health-policy Especificación codificada json de la directiva de mantenimiento que se usa de forma predeterminada para evaluar el estado de un tipo de servicio.
--failure-action La acción que se debe realizar cuando una actualización supervisada encuentra infracciones de la directiva de supervisión o de la directiva de mantenimiento.
--force-restart Reinicie los procesos de forma forzada durante la actualización incluso cuando la versión del código no haya cambiado.
--health-check-retry-timeout El período de tiempo entre los intentos de realizar comprobaciones de estado si la aplicación o el clúster no están en buen estado. Valor predeterminado: PT0H10M0S.
--health-check-stable-duration La cantidad de tiempo que la aplicación o el clúster deben permanecer en buen estado antes de que la actualización continúe con el siguiente dominio de actualización. Valor predeterminado: PT0H2M0S.

Se interpreta por primera vez como una cadena que representa una duración ISO 8601. Si se produce un error, se interpreta como un número que representa el número total de milisegundos.
--health-check-wait-duration Período de tiempo que se debe esperar después de completar un dominio de actualización antes de iniciar el proceso de comprobación de estado. Valor predeterminado: 0.
--max-unhealthy-apps Porcentaje máximo permitido de aplicaciones implementadas con estado incorrecto. Representado como un número entre 0 y 100.
--mode Modo que se usa para supervisar el estado durante una actualización gradual. Valor predeterminado: UnmonitoredAuto.
--replica-set-check-timeout Cantidad máxima de tiempo para bloquear el procesamiento de un dominio de actualización y evitar la pérdida de disponibilidad cuando hay problemas inesperados. Medido en segundos.
--service-health-policy Asignación codificada en JSON con la directiva de mantenimiento del tipo de servicio por nombre de tipo de servicio. El mapa está vacío de forma predeterminada.
--timeout -t Valor predeterminado: 60.
--upgrade-domain-timeout La cantidad de tiempo que cada dominio de actualización tiene que completarse antes de que se ejecute FailureAction. Valor predeterminado: P10675199DT02H48M05.4775807S.

Se interpreta por primera vez como una cadena que representa una duración ISO 8601. Si se produce un error, se interpreta como un número que representa el número total de milisegundos.
--upgrade-timeout La cantidad de tiempo que debe completarse la actualización general antes de que se ejecute FailureAction. Valor predeterminado: P10675199DT02H48M05.4775807S.

Se interpreta por primera vez como una cadena que representa una duración ISO 8601. Si se produce un error, se interpreta como un número que representa el número total de milisegundos.
--warning-as-error Indica si las advertencias se tratan con la misma gravedad que los errores.

Argumentos globales

Argumento Descripción
--debug Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
--help -h Mostrar este mensaje de ayuda y salir.
--output -o Formato de salida. Valores permitidos: json, jsonc, table y tsv. Valor predeterminado: json.
--query Cadena de consulta JMESPath. Para obtener más información y ejemplos, vea https://jmespath.org/.
--verbose Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

sfctl application upgrade-resume

Reanuda la actualización de una aplicación en el clúster de Service Fabric.

Reanuda una actualización de la aplicación de Service Fabric manual no supervisada. Service Fabric actualiza un dominio de actualización cada vez. Para las actualizaciones manuales no supervisadas, después de que Service Fabric finalice un dominio de actualización, espera a que llame a esta API antes de continuar con el siguiente dominio de actualización.

Argumentos

Argumento Descripción
--application-id [Obligatorio] Identidad de la aplicación. Normalmente es el nombre completo de la aplicación sin el esquema de URI "fabric:". A partir de la versión 6.0, los nombres jerárquicos se delimitan con el carácter "~". Por ejemplo, si el nombre de la aplicación es "fabric:/myapp/app1", la identidad de la aplicación sería "myapp~app1" en 6.0+ y "myapp/app1" en versiones anteriores.
--upgrade-domain-name [Obligatorio] Nombre del dominio de actualización en el que se reanudará la actualización.
--timeout -t El tiempo límite del servidor para realizar la operación en segundos. Este tiempo de espera especifica el tiempo que el cliente está dispuesto a esperar para que se complete la operación solicitada. El valor por defecto de este parámetro es 60 segundos. Valor predeterminado: 60.

Argumentos globales

Argumento Descripción
--debug Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
--help -h Mostrar este mensaje de ayuda y salir.
--output -o Formato de salida. Valores permitidos: json, jsonc, table y tsv. Valor predeterminado: json.
--query Cadena de consulta JMESPath. Para obtener más información y ejemplos, vea https://jmespath.org/.
--verbose Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

sfctl application upgrade-rollback

Comienza a revertir la actualización en curso de una aplicación en el clúster de Service Fabric.

Comienza a revertir la actualización de la aplicación actual a la versión anterior. Esta API solo se puede usar para revertir la actualización en curso actual que se está reenviando a una nueva versión. Si la aplicación no se está actualizando actualmente, use startApplicationUpgrade API para actualizarla a la versión deseada, incluida la revierte a una versión anterior.

Argumentos

Argumento Descripción
--application-id [Obligatorio] Identidad de la aplicación. Normalmente es el nombre completo de la aplicación sin el esquema de URI "fabric:". A partir de la versión 6.0, los nombres jerárquicos se delimitan con el carácter "~". Por ejemplo, si el nombre de la aplicación es "fabric:/myapp/app1", la identidad de la aplicación sería "myapp~app1" en 6.0+ y "myapp/app1" en versiones anteriores.
--timeout -t El tiempo límite del servidor para realizar la operación en segundos. Este tiempo de espera especifica el tiempo que el cliente está dispuesto a esperar para que se complete la operación solicitada. El valor por defecto de este parámetro es 60 segundos. Valor predeterminado: 60.

Argumentos globales

Argumento Descripción
--debug Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
--help -h Mostrar este mensaje de ayuda y salir.
--output -o Formato de salida. Valores permitidos: json, jsonc, table y tsv. Valor predeterminado: json.
--query Cadena de consulta JMESPath. Para obtener más información y ejemplos, vea https://jmespath.org/.
--verbose Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

sfctl application upgrade-status

Obtiene los detalles de la actualización más reciente realizada en esta aplicación.

Devuelve información sobre el estado de la actualización de la aplicación más reciente junto con detalles para ayudar a depurar problemas de estado de la aplicación.

Argumentos

Argumento Descripción
--application-id [Obligatorio] Identidad de la aplicación. Normalmente es el nombre completo de la aplicación sin el esquema de URI "fabric:". A partir de la versión 6.0, los nombres jerárquicos se delimitan con el carácter "~". Por ejemplo, si el nombre de la aplicación es "fabric:/myapp/app1", la identidad de la aplicación sería "myapp~app1" en 6.0+ y "myapp/app1" en versiones anteriores.
--timeout -t El tiempo límite del servidor para realizar la operación en segundos. Este tiempo de espera especifica el tiempo que el cliente está dispuesto a esperar para que se complete la operación solicitada. El valor por defecto de este parámetro es 60 segundos. Valor predeterminado: 60.

Argumentos globales

Argumento Descripción
--debug Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
--help -h Mostrar este mensaje de ayuda y salir.
--output -o Formato de salida. Valores permitidos: json, jsonc, table y tsv. Valor predeterminado: json.
--query Cadena de consulta JMESPath. Para obtener más información y ejemplos, vea https://jmespath.org/.
--verbose Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

carga de la aplicación sfctl

Copie un paquete de aplicación de Service Fabric en el almacén de imágenes.

Opcionalmente, muestra el progreso de la carga de cada archivo del paquete. El progreso de la carga se envía a stderr.

Argumentos

Argumento Descripción
--path [Obligatorio] Ruta de acceso al paquete de aplicación local.
--compress Solo se aplica a los paquetes de aplicación de Service Fabric. Cree una carpeta que contenga el paquete de aplicación comprimido en la ubicación predeterminada o en la ubicación especificada por el parámetro de ubicación comprimida y, a continuación, cargue la carpeta recién creada.

Si ya hay un archivo comprimido generado por sfctl, se sobrescribe si se establece esta marca. Se devuelve un error si el directorio no es un paquete de aplicación. Si ya es un paquete de aplicación comprimido, la carpeta se copia tal como está. De forma predeterminada, el paquete de aplicación comprimido recién creado se eliminará después de una carga correcta. Si la carga no se realiza correctamente, limpie manualmente el paquete comprimido según sea necesario. La eliminación no quita ningún dirs vacío creado si el parámetro de ubicación comprimida hace referencia a directorios inexistentes.
--compressed-location Ubicación para colocar el paquete de aplicación comprimido.

Si no se proporciona ninguna ubicación, el paquete comprimido se coloca en una carpeta recién creada denominada sfctl_compressed_temp en el directorio primario especificado en el argumento path. Por ejemplo, si el argumento path tiene el valor C:/FolderA/AppPkg, el paquete comprimido se agrega a C:/FolderA/sfctl_compressed_temp/AppPkg.
--imagestore-string Almacén de imágenes de destino en el que cargar el paquete de aplicación. Valor predeterminado: fabric:ImageStore.

Para cargar en una ubicación de archivo, inicie este parámetro con "file:". De lo contrario, el valor debe ser la cadena de conexión del almacén de imágenes, como el valor predeterminado.
--keep-compressed Indica si se debe mantener o no el paquete comprimido generado al finalizar correctamente la carga.

Si no se establece, al finalizar correctamente, se eliminan los paquetes de aplicación comprimidos. Si la carga no se realizó correctamente, el paquete de aplicación siempre se mantendrá en el directorio de salida para volver a cargar.
--show-progress Mostrar el progreso de la carga de archivos para paquetes grandes.
--timeout -t Tiempo de espera total en segundos. Se producirá un error de carga y se devolverá un error después de que se supere la duración del tiempo de espera de carga. Este tiempo de espera se aplica a todo el paquete de aplicación y los tiempos de espera de archivo individuales equivalen a la duración de tiempo de espera restante. El tiempo de espera no incluye el tiempo necesario para comprimir el paquete de aplicación. Valor predeterminado: 300.

Argumentos globales

Argumento Descripción
--debug Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
--help -h Mostrar este mensaje de ayuda y salir.
--output -o Formato de salida. Valores permitidos: json, jsonc, table y tsv. Valor predeterminado: json.
--query Cadena de consulta JMESPath. Para obtener más información y ejemplos, vea https://jmespath.org/.
--verbose Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Pasos siguientes

  • Last updated on