Control de la instalación de componentes opcionales

El software puede tener componentes que son opcionales y componentes que son mutuamente excluyentes. Algunos ejemplos de componentes opcionales son las configuraciones regionales y la documentación. Algunos ejemplos de componentes mutuamente excluyentes son SPARC o x86, y archivos binarios de depuración y no depuración. En IPS, los componentes opcionales se denominan facetas y los componentes mutuamente excluyentes se denominan variantes.

Las facetas y las variantes son propiedades especiales definidas en la imagen y son etiquetas definidas en las acciones dentro de un paquete. La mayoría de las etiquetas de variantes pueden tener diversos valores. Las etiquetas de facetas definidas en una acción sólo pueden tener el valor true. La comparación entre los valores de las etiquetas de faceta y variante de una acción y los valores de las facetas y las variantes esablecidos en la imagen permite determinar si la acción de paquete se puede instalar. Por ejemplo, si define una faceta de configuración regional determinada en false, no se instalarán los archivos u otras acciones que especifiquen esa faceta y se desinstalarán los archivos instalados que especifiquen esa faceta.

Para ver los valores actuales de las facetas y las variantes configuradas en la imagen, use los comandos pkg facet y pkg variant. Para modificar los valores de las facetas y las variantes definidas en la imagen, use los comandos pkg change-facet y pkg change-variant. Consulte la página del comando man pkg(1) y los ejemplos a continuación.

Cada etiqueta de faceta y variante tiene un nombre y un valor. Una sola acción puede tener varias etiquetas de facetas y variantes. Un ejemplo de un componente con varias etiquetas de faceta y variante es un archivo de encabezado específico de arquitectura que utilizan los desarrolladores o un componente que es solamente para una zona global de SPARC.

Un ejemplo de una etiqueta de variante es variant.arch=sparc. Un ejemplo de una etiqueta de faceta es facet.devel=true. Por lo general, se hace referencia a las facetas y las variantes sin el inicio facet. ni variant..

Las facetas son booleanas: sólo se pueden establecer en true (activadas) o false (desactivadas). De manera predeterminada, se considera que todas las facetas están establecidas en true, en la imagen. Una etiqueta de faceta en una acción sólo debe tener el valor true; los demás valores tienen comportamiento indefinido. Una faceta establecida en la imagen puede ser una faceta completa, como doc.man, o un patrón, como locale.*. Esta flexibilidad es útil si desea desactivar una parte del espacio de nombres de la faceta y activar solamente facetas individuales en él. Por ejemplo, puede desactivar todas las configuraciones regionales y luego puede activar sólo una o dos configuraciones regionales específicas, como se muestra en el siguiente ejemplo:

$ pfexec pkg change-facet 'locale.*=false'
[output about packages being updated]
$ pfexec pkg change-facet locale.en_US=true
[output about packages being updated]

La mayoría de las variantes pueden tener cualquier cantidad de valores. Por ejemplo, la variante arch se puede establecer en i386, sparc, ppc o arm, o en cualquier arquitectura que la distribución admita. (Sólo i386 y sparc se utilizan en Oracle Solaris). La excepción son las variantes debug. Las variantes debug sólo se pueden definir en true o false; los demás valores tienen un comportamiento indefinido. Si la acción de un archivo tiene versiones de depuración y de no depuración, ambas versiones deben tener la variante debug aplicable explícitamente establecida, como se muestra en el siguiente ejemplo:

file group=sys mode=0644 overlay=allow owner=root \
  path=etc/motd pkg.csize=115 pkg.size=103 preserve=true \
  variant.debug.osnet=true

file group=sys mode=0644 overlay=allow owner=root \
  path=etc/motd pkg.csize=68 pkg.size=48 preserve=true \
  variant.debug.osnet=false 

El valor de la variante se debe definir en la imagen para que un paquete que usa la variante se instale. Las variantes arch y zone son definidas por el programa que crea la imagen e instala su contenido inicial. De manera predeterminada, las variantes debug.* son false en la imagen.

El siguiente algoritmo describe la forma en que las facetas y las variantes establecidas en la imagen afectan si una determinada acción está instalada.

• Las acciones sin etiquetas de facetas o variantes siempre se instalan.

• Se instalan las acciones con etiquetas de facetas, a menos que todas las facetas o los patrones de facetas que coinciden con las etiquetas estén establecidos en false, en la imagen. Si alguna faceta está establecida en true o no está establecida de forma explícita (true es el valor predeterminado), se instala la acción.

• Las acciones con etiquetas de variantes se instalan sólo si los valores de todas las etiquetas de variantes son los mismos que los definidos en la imagen.

• Las acciones con etiquetas de facetas y variantes se instalan si tanto las facetas como las variantes permiten que la acción se instale.

Puede crear sus propias etiquetas de facetas y variantes. Las siguientes etiquetas se utilizan con frecuencia en Oracle Solaris.

A continuación, se muestran algunos ejemplos de las etiquetas de facetas que se utilizan en Oracle Solaris:

facet.devel             facet.doc
facet.doc.html          facet.doc.info
facet.doc.man           facet.doc.pdf
facet.locale.de         facet.locale.en_GB
facet.locale.en_US      facet.locale.fr
facet.locale.ja_JP      facet.locale.zh_CN

Puede visualizar los valores de variantes y facetas que están establecidos en la imagen actual, y puede cambiar variantes y facetas en la imagen actual. El cambio de variantes y facetas podría actualizar un gran número de paquetes y podría requerir un nuevo entorno de inicio. Use -nv para revisar qué cambios se realizarán antes de realizar cambios.

Visualización y cambio de valores de variantes

Utilice el comando pkg variant para mostrar los valores de variantes que están establecidos.

/usr/bin/pkg variant [-H] [variant_nsmr ...]

$ pkg variant
VARIANT                  VALUE
variant.opensolaris.zone global
variant.arch             i386
$ pkg variant -H variant.arch
variant.arch i386

Utilice el comando pkg change-variant para cambiar el valor de una variante.

/usr/bin/pkg change-variant [-nvq] [-C n] [-g path_or_uri ...]
    [--accept] [--licenses] [--no-be-activate]
    [--no-backup-be | --require-backup-be] [--backup-be-name name]
    [--deny-new-be | --require-new-be] [--be-name name]
    variant_name=value ...

El siguiente comando genera una gran cantidad de salida debido a que muchos paquetes se verían afectados. Tenga en cuenta que no se crearía un nuevo entorno de inicio de manera predeterminada, sino que se crearía una copia de seguridad del entorno de inicio. Consulte Propiedades de imágenes de política de entorno de inicio para obtener información sobre cuándo se crean entornos de inicio.

Use la opción -C para cambiar variantes en zonas no globales n de forma simultánea con la zona global. Consulte Actualización de varias zonas no globales simultáneamente para ver un ejemplo de cómo usar la opción -C.

Utilice la opción -n para ver lo que cambiaría si realizara la operación sin -n, pero sin realizar cambios reales.

$ pfexec pkg change-variant -nv --accept 'variant.debug.*=true'
            Packages to update:       851
     Variants/Facets to change:         3
     Estimated space available:  49.88 GB
Estimated space to be consumed: 270.57 MB
       Create boot environment:        No
Create backup boot environment:       Yes
          Rebuild boot archive:        No

Changed variants/facets:
  variant variant.debug.*: true
    facet facet.locale.en_US: None
    facet facet.locale.*: None
Changed packages:
solaris
  ...

Visualización y cambio de valores de faceta

Utilice el comando pkg facet para mostrar los valores de facetas que están establecidos.

/usr/bin/pkg facet [-H] [facet_name ...]

$ pkg facet
FACETS             VALUE
facet.locale.en_US True
facet.locale.en    True
facet.locale.*     False
$ pkg facet -H 'facet.locale.*'
facet.locale.* False

Utilice el comando pkg change-facet para cambiar el valor de una faceta.

/usr/bin/pkg change-facet [-nvq] [-C n] [-g path_or_uri ...]
    [--accept] [--licenses] [--no-be-activate]
    [--no-backup-be | --require-backup-be] [--backup-be-name name]
    [--deny-new-be | --require-new-be] [--be-name name] 
    facet_name=[True|False|None] ...

Use la opción -C para cambiar facetas en zonas no globales n de forma simultánea con la zona global. Consulte Actualización de varias zonas no globales simultáneamente para ver un ejemplo de cómo usar la opción -C.

Utilice la opción -n para ver lo que cambiaría si realizara la operación sin -n, pero sin realizar cambios reales.

Si el valor de la faceta está establecido en None, la especificación de la faceta se elimina de la imagen actual.

El siguiente comando genera una gran cantidad de salida debido a que muchos paquetes se verían afectados. Esta operación podría requerir una gran cantidad de tiempo y provocar una gran cantidad de tráfico de red entre esta imagen y el repositorio de paquetes. Tenga en cuenta que no se crearía un nuevo entorno de inicio de manera predeterminada, sino que se crearía una copia de seguridad del entorno de inicio. Consulte Propiedades de imágenes de política de entorno de inicio para obtener información sobre cuándo se crean entornos de inicio.

$ pfexec pkg change-facet -nv 'facet.locale.*=true'
            Packages to update:      851
     Variants/Facets to change:        1
     Estimated space available: 49.88 GB
Estimated space to be consumed:  3.13 GB
       Create boot environment:       No
Create backup boot environment:      Yes
          Rebuild boot archive:       No

Changed variants/facets:
    facet facet.locale.*: True
Changed packages:
solaris
  ...