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