Referência bfexport

Utilize o comando bfexport para exportar dados do projeto para um arquivo chamado XML ou para enviar dados do projeto para o terminal de exibição (sdout) para visualização. Um arquivo de exportação contém dados de configuração para um único projeto ou para uma captura instantânea do projeto.

Sintaxe

bfexport

bfexport [-l]

bfexport [-l] <project_name>
bfexport [-c "<comment>"] [-f <file_name>] [-g] [-s] [-C] [-L ] [-n ] 
<project_name> | <project_name> <snapshot_name> | <project_id>

Uso

Para concluir tarefas de exportação de um projeto comum, utilize estas opções de comando:
  • Para exibir sintaxe de comando, utilize bfexport sem opções.
  • Para listar os nomes de projetos e IDs do projeto que são armazenados no banco de dados do Build Forge, utilize bfexport -l.

    Os nomes de capturas instantâneas são anexados ao nome do projeto da saída de comando: <project_ID>: <project_name> – <snapshot_name>

  • Para enviar dados do projeto para um arquivo XML, bfexport -f <file_name>. Você deve especificar a opção -f <file_name> para gerar um arquivo que possa ser usado para importar dados do projeto.
  • Na plataforma z/Linux, você deve executar o comando como bfexport.pl. Em todas as outras plataformas, o comando não exige uma extensão.

Pré-requisitos e Restrições

Encontre o utilitário bfexport em seu diretório de instalação do Build Forge.

Senhas de autorização do servidor para servidores que não são incluídas no arquivo de exportação; após a importação, você deve inserir manualmente as senhas de autorização do servidor na UI.

O comando bfexport deve ser capaz de encontrar o arquivo buildforge.conf e acessar o banco de dados do Build Forge. Execute bfexport a partir do diretório em que buildforge.conf está localizado, o qual está em <bfinstall> no Windows e em <bfinstall>/Platform no UNIX e Linux.

Exemplos

Para gravar a saída em um arquivo, use a opção -f <file_name>. No exemplo a seguir, helloworld é o nome do arquivo de saída e o ID do projeto é utilizado em vez do nome do projeto.

bfexport -c "Salvando uma cópia do projeto antes de fazer alterações" 
 -f helloworld 675B57CC-8366-11DD-B2E0-043C04E44E1A

Para exportar a captura instantânea do projeto padrão apenas, use o <project_name>.

bfexport -f helloworld test_project

Para exportar uma captura instantânea de um projeto, use o <project_name> <snapshot_name>.

bfexport -f helloworld test_project snapshot_1

Se a captura instantânea do projeto pai não for o projeto padrão, você deverá especificar o <project_name> seguido pela palavra-chave pai para exportar a captura instantânea do projeto pai.

bfexport -f helloworld test_project parent

Descrições de Opções

Opção Descrição
<project_name> O nome do projeto a ser exportado. O nome do projeto ou o ID do projeto é obrigatório. Se o nome do projeto contiver espaços, você deve colocar o nome entre aspas.

Especifique o nome do projeto após as opções de comando.

<snapshot_name> O nome da captura instantânea do projeto a ser exportada; o nome do projeto é necessário, conforme mostrado na seguinte sintaxe:
<project_name> <snapshot_name>

Especifique o nome do projeto e o nome da captura instantânea após as opções de comando. Se o nome do projeto ou da captura instantânea contiver espaços, você deve colocá-lo entre aspas.

<project_id> O identificador do projeto a ser exportado. O ID do projeto é um UUID. O ID do projeto ou o nome do projeto é obrigatório.

Especifique o ID do projeto após as opções de comando.

-f <file_name> Um nome de arquivo XML para a saída bfexport. Se você não fornecer um nome de caminho, o diretório de trabalho atual será utilizado. Se o nome do arquivo contiver espaços, você deverá colocá-lo entre aspas.

Se você não fornecer um nome de arquivo, a saída bfexport será enviada para stdout.

Nota: Utilize stdout apenas para visualização. Não redirecione stdout para um arquivo; o arquivo resultante inclui mensagens de login e não pode ser utilizado como um arquivo de importação para o comando bfimport ou o utilitário de importação da UI.
pai Uma palavra-chave que é necessária para exportar uma captura instantânea do projeto pai se o pai não for a captura instantânea padrão do projeto.

Especifique a palavra-chave pai após o nome da captura instantânea do projeto:

bfexport -f helloworld test_project parent
-l Lista os projetos do banco de dados por nome e ID do projeto. Você não pode utilizar a opção -l com outras opções.
- c "<comment>" Inclui um comentário. Você deve colocar o comentário entre aspas (por exemplo, "versão do meu projeto 50"). O comentário é incluído no elemento XML <buildforge>.
-g Salva no arquivo XML os usuários que são membros dos grupos de acesso designados para receber notificações. Os usuários e suas propriedades são listadas no elemento XML <user>. Exige -s.
-s Salva no arquivo XML os servidores definidos no Console de Gerenciamento. Os servidores e suas propriedades são listados no elemento XML <server>, junto com quaisquer informações associadas <auth> e <collector>.
-L Salva no arquivo XML os controladores de domínio do LDAP definidos na UI. Os controladores de domínio LDAP e suas propriedades são listados no elemento XML <ldap>.
-n Salva no arquivo XML os modelos de notificação designados ao projeto e às etapas. Os modelos de notificação e suas propriedades são listados no elemento XML <mail-template>.
-C Salva no arquivo XML os coletores designados aos servidores do projeto. Os coletores e suas propriedades são listados no elemento XML <collector>. Exige -s.

Resolução de Problemas

Se você encontrar erros que relatem que não é possível localizar arquivos ou bibliotecas, certifique-se de que o caminho da biblioteca esteja configurado corretamente.

As configurações corretas estão em <bfinstall>/rc/buildforge. Verifique a variável do caminho da biblioteca e outras variáveis configuradas nesse arquivo. Reconfigure-as, conforme necessário e, em seguida, exporte-as.


Feedback