publish

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

Feedback