publish

Utilice este mandato para publicar un paquete.

Objetivo

El mandato publish se utiliza para publicar un paquete en el servidor de bibliotecas o para actualizar un paquete en el servidor de bibliotecas. Para publicar un paquete, debe haber un archivo descriptor disponible. Un archivo descriptor de paquetes describe un solo paquete que corresponde a un activo en Rational Asset Manager.

Parámetros

Puede utilizar el mandato publish sin argumentos con un archivo comprimido o con una ubicación. Además puede especificar el archivo de configuración en la línea de mandatos.
Argumento Descripción Necesario
-o Utilice el parámetro -o para sobrescribir un paquete existente en el servidor de bibliotecas. No
(ningún argumento proporcionado) El descriptor de paquete debe estar en el directorio actual. Todos los archivos del directorio actual se suben como artefactos al activo del servidor de bibliotecas. Si el directorio actual no contiene un descriptor de paquete, se busca un descriptor de paquete en todos los subdirectorios. Cada subdirectorio que contiene un descriptor de paquete se trata como un paquete a publicar. No
archivo_comprimido El paquete debe estar comprimido en el formato .zip. El descriptor de paquete debe estar en la carpeta raíz del archivo comprimido. El archivo comprimido se extrae y los archivos del archivo de archivado se suben como artefactos al activo al servidor de bibliotecas. No
nombre_de_vía_acceso El descriptor de paquete debe estar en la raíz de la ubicación. Todos los archivos de la ubicación se suben como artefactos al activo del servidor de bibliotecas. Si la ubicación no contiene un descriptor de paquete, se busca un descriptor de paquete en todos los subdirectorios. Cada subdirectorio que contiene un descriptor de paquete se trata como un paquete a publicar. Puede utilizar este parámetro para publicar varios paquetes a la vez. Tenga en cuenta que los paquetes no se pueden definir dentro de otros paquetes. No
-c nombre_de_componente:valor_de_componente El nombre y la versión de un paquete de componentes a crear en el servidor de bibliotecas. Un paquete de componentes representa todos los paquetes subidos por el mandato publish. No
-id ID_de_construcción El valor a sustituir para la variable SNAPSHOT al publicar. No
-config archivo_de_configuración La vía de acceso completa del archivo de configuración a utilizar para la comunicación con el servidor de bibliotecas. Si no especifica un archivo de configuración en la línea de mandatos, se utiliza el archivo de configuración del subdirectorio .ram en el directorio inicial del usuario actual. No, mientras el archivo de configuración predeterminado exista en el subdirectorio .ram del directorio inicial del usuario actual.

Sintaxis de descriptor de paquete

Un paquete es una colección de archivos. Los entregables de aplicación, los scripts de instalación y la documentación pueden ser paquetes. La interfaz de línea de mandatos reconoce el archivo JSON package.json como el descriptor de paquete. La interfaz de línea de mandatos también reconoce los archivos Maven pom.xml y .pom como descriptores de paquete pero si hay varios descriptores de paquete para un paquete, el archivo package.json tiene preferencia. El descriptor de paquete debe incluir los parámetros id y version para el paquete. Otros parámetros del descriptor de paquete son opcionales. Si publica utilizando un archivo POM de Maven como el descriptor de paquete, el parámetro groupId del archivo POM se crea como atributo Group.Id en el activo.

id
El ID de paquete debe ser exclusivo.
version
La versión de paquete se maneja mediante reglas de mantenimiento de versiones. Para aprender más sobre las reglas de mantenimiento de versiones, consulte Semantic Versioning. También puede utilizar la palabra reservada SNAPSHOT para establecer la indicación de la hora de la construcción actual. Por ejemplo, la versión 1.0.0-SNAPSHOT se ampliaría a 1.0.0-20101120-1700 si la construcción más actual se ejecutó el 20 de noviembre de 2010 a las 17:00.
description
El texto descriptivo del paquete es opcional.
owners
El parámetro owners es una matriz de personas descrita mediante el formato siguiente:
{   "name" : "Simone Dray",
	  "email" : "simdray@example.com",
	  "url" : "http://simdray.example.com"
}
También puede utilizar una versión abreviada de la información como en el ejemplo siguiente: "Simone Dray <simdray@example.com> (http://simdray.example.com)". En cualquier formato, los parámetros email y url son opcionales. Si no especifica un parámetro owners, el propietario del activo publicado se establece en el usuario especificado en el archivo de configuración.
type
El parámetro type se utiliza para establecer el tipo de activo en Rational Asset Manager. Si no especifica un parámetro type, se presupone un parámetro type de Implementation.
dependencies
El parámetro dependencies es una matriz de información que describe otros paquetes de los que este paquete depende. El ID de paquete es necesario. Un número de versión o una serie de consulta son opcionales. Para buscar un activo en un estado determinado, utilice state:(state_name) para la serie de consulta. Para buscar un ID, utilice id:(ID) para la serie de consulta. También puede utilizar un atajo de búsqueda de Rational Asset Manager como la serie de consulta, por ejemplo: ramSearch:(1txt%2Ckeyword). Puede obtener atajos de búsqueda pulsando el icono Ver acceso directo de búsqueda después de buscar en Rational Asset Manager.
La tabla siguiente muestra cómo los parámetros del archivo POM de Maven se correlacionan con los parámetros del archivo package.json.
Parámetro del archivo package.json Parámetro del archivo POM de Maven
id artifactId
version version
description description
type No aplicable. Cuando publica mediante un archivo POM, el tipo se establece en Implementation.
owners contributor
dependencies No aplicable.

Archivo package.json de ejemplo

{
  "id": "jke",
  "version": "2.1.0-SNAPSHOT",
  "description": "Provides checking account services.",
  "owners" :  [
      { "name" : "Bill Jordan", "email" : "bjordan@example.com" } ,
      { "name" : "Lisa Starky", "email" : "lstarky@example.com" }
  ],
  "type" : "implementation",
  "dependencies": [
      { "id" : "JKE_infra", "version" : "2.1-SNAPSHOT" } ,
      { "id" : "devops_cookbooks-3.0", "query" : "state:(ready for verification)" }
  ]
}
ram publish newpackage.zip

Comentarios