Use esse comando para publicar pacotes.
Propósito
O comando publish
é usado para publicar um pacote no servidor de bibliotecas ou para atualizar um
pacote no servidor de bibliotecas. Para publicar um pacote, um arquivo descritor
de pacote deve estar disponível. Um arquivo descritor de pacote descreve um único
pacote, que corresponde aum ativo no Rational Asset Manager.
Parâmetros
É possível usar o comando
publish
sem argumentos com um arquivo compactado ou com um local. Além disso,
é possível especificar o arquivo de configuração na linha de comandos.
| Argumento |
Descrição |
Obrigatório |
| -o |
Use o parâmetro -o para sobrescrever um
pacote existente no servidor de bibliotecas. |
Não |
| (nenhum argumento fornecido) |
O descritor de pacote deve estar no diretório atual.
Todos os arquivos no diretório atual são transferidos por upload como artefatos para o
ativo no servidor de bibliotecas. Se o diretório atual não contiver
um descritor de pacote, todos os subdiretórios serão procurados em busca de um descritor
de pacote. Cada subdiretório que contém um descritor de pacote é
tratado como um pacote a ser publicado. |
Não |
| compressed_file |
O pacote deve ser compactado no formato .zip.
O descritor de pacote deve estar na pasta raiz no arquivo
compactado. O arquivo compactado é extraído e, em seguida, os arquivos no
archive são transferidos por upload como artefatos para o ativo no servidor de bibliotecas. |
Não |
| pathname |
O descritor de pacote deve estar na raiz do local.
Todos os arquivos no local são transferidos por upload como artefatos para o ativo
no servidor de bibliotecas. Se o local não contiver um descritor de
pacote, todos os subdiretórios serão procurados em busca de um descritor de pacote.
Cada subdiretório que contém um descritor de pacote é tratado como
um pacote a ser publicado. É possível usar esse parâmetro para publicar vários
pacotes por vez. Observe que os pacotes não podem ser definidos dentro de outros
pacotes. |
Não |
| -c component_name:component_value |
O nome e a versão de um pacote de componentes a ser criado no
servidor de bibliotecas. Um pacote de componentes representa todos os pacotes
transferidos por upload pelo comando publish. |
Não |
| -id build_ID |
O valor a ser substituído para a variável SNAPSHOT
na publicação. |
Não |
| -config configuration_file |
O caminho completo para o arquivo de configuração a ser usado para comunicação
com o servidor de bibliotecas. Se você não especificar um arquivo de configuração
na linha de comandos, o arquivo de configuração padrão no subdiretório .ram
no diretório inicial do usuário atual será usado. |
Não, contanto que o arquivo de configuração padrão exista no subdiretório .ram
do diretório inicial do usuário atual. |
Sintaxe do Descritor de Pacote
Um pacote é uma
coleção de arquivos. As entregas de aplicativos, scripts de instalação
e documentação podem ser pacotes. A interface da linha de comandos
reconhece o arquivo JSON package.json como o
descritor de pacote. A interface da linha de comandos também reconhece os arquivos Maven pom.xml e .pom
como descritores de pacotes, mas se vários descritores de pacotes estiverem disponíveis
para qualquer pacote, o arquivo package.json terá
precedência. O descritor de pacote deve incluir os parâmetros id e version
para o pacote. Outros parâmetros no descritor de pacote são opcionais.
Se você publicar usando um arquivo Maven POM como o descritor de pacote,
o parâmetro groupId do arquivo POM será criado
como o atributo Group.Id no ativo.
- id
- O ID do pacote deve ser exclusivo.
- version
- A versão do pacote é manipulada usando regras de versão semântica.
Para saber mais sobre regras de versão semântica, consulte Versão Semântica.
Também é possível usar a palavra reservada SNAPSHOT para
indicar o registro de data e hora da construção atual. Por exemplo, a versão 1.0.0-SNAPSHOT
seria expandida para 1.0.0-20101120-1700 se a construção mais atual fosse executada em
20 de novembro de 2010 às 17h.
- description
- Uma descrição textual do pacote é opcional.
- owners
- O parâmetro owners é uma matriz de pessoas
descrita usando o formato a seguir:
{ "name" : "Simone Dray",
"email" : "simdray@example.com",
"url" : "http://simdray.example.com"
}
Também é possível usar uma versão encurtada das informações,
como no exemplo a seguir: "Simone Dray <simdray@example.com>
(http://simdray.example.com)". Em qualquer um dos formatos, os parâmetros email e url
são opcionais. Se você não especificar um parâmetro owners,
o proprietário do ativo publicado será configurado para o usuário especificado no
arquivo de configuração.
- type
- O parâmetro type é usado para configurar o tipo de
ativo no Rational Asset Manager.
Se você não especificar um parâmetro type, um parâmetro type
de Implementation será assumido.
- dependencies
- O parâmetro dependencies é uma matriz de
informações que descreve outros pacotes dos quais este pacote depende.
O ID do pacote é necessário. Um número de versão ou sequência de consultas é opcional.
Para procurar um ativo em um estado específico, use state:(state_name) par
a sequência de consultas. Para procurar um ID, use id:(ID) para
a sequência de consultas. Também é possível usar um atalho de procura do Rational Asset Manager
como a sequência de consultas, por exemplo: ramSearch:(1txt%2Ckeyword).
É possível obter atalhos de procura clicando no ícone Visualizar Atalho
de Procura após a procura no Rational Asset Manager.
A tabela a seguir mostra como os parâmetros do arquivo Maven POM
são mapeados para os parâmetros do arquivo
package.json.
| Parâmetro do arquivo package.json |
Parâmetro do arquivo Maven POM |
| id |
artifactId |
| version |
version |
| description |
description |
| type |
Não aplicável. Quando você publica usando um arquivo POM, tipo
é configurado para Implementation. |
| owners |
contributor |
| dependencies |
Não aplicável. |
Arquivo package.json de Exemplo
{
"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