Executando Programas Remotamente Utilizando Ferramentas Externas

Você pode executar programas ou construções remotas de várias formas: utilizando comandos de compilação, configurações de ativação de execução, shell remoto ou ferramentas externas. Ao utilizar comandos de compilação, você navega para o programa no servidor remoto que deseja executar, clica com o botão direito do mouse e chama os comandos de compilação baseados na entrada padrão. Ao ativar um shell remoto, você pode navegar para o diretório remoto e executar construções diretamente no servidor remoto. Esses métodos serão adequados apenas se você precisar executar um programa remoto ocasionalmente, mas para trabalhar em um ambiente de projeto mais gerenciado você poderá utilizar configurações de ativação de ferramentas externas. A seguinte documentação descreve como utilizar ferramentas externas para executar seus programas remotamente. Essa função aplica-se a programas que residem no IFS (Integrated File System) do iSeries ou em um servidor remoto Window, Linux, UNIX ou AIX.

As ferramentas externas representam uma estrutura padrão do Eclipse projetada para que você possa configurar e chamar ferramentas que são executadas fora do Eclipse. Depois de criar uma configuração de ferramenta externa, você pode chamar a mesma ação rápida e facilmente com um atalho de menu da barra de ferramentas ou do workbench. Dessa forma, você pode definir uma configuração para construir seu projeto remoto, depois que tal configuração existir, apenas clicando nela e chamando-a novamente.

Para criar uma configuração de ativação de ferramenta externa:

  1. No menu do workbench, clique em Run > External Tools > External Tools....
  2. Na lista de configurações no lado esquerdo da caixa de diálogo, selecione Remote Build.
  3. Na parte inferior da caixa de diálogo, clique em New.
  4. No campo Name, digite um nome adequado para a configuração, como Project Build A.
  5. No campo Connection, utilize a lista drop-down para selecionar a conexão que você está utilizando para se conectar ao servidor remoto. (Se você ainda não tiver uma conexão a um servidor remoto, expanda New Connection e preencha a caixa de diálogo. Consulte Configurando uma Conexão a um Servidor Remoto para obter informações adicionais).
  6. No campo Build Invocation, digite o comando que deseja executar no servidor, por exemplo, javac *.java. Esse é o comando executado quando você chama a construção remota.
  7. No campo Working Directory, clique em Browse File System. Procure o diretório no servidor remoto no qual deseja construir a execução. Clique em OK. Aqui há um exemplo de como sua caixa de diálogo deve se parecer:

  8. Marque Has associated project se você estiver utilizando um pacote local do código remoto. Se você estiver trabalhando em um ambiente de projeto gerenciado, um projeto local será vantajoso porque ele fornece um contêiner local para a origem remota, com a qual você pode trabalhar enquanto estiver conectado ao servidor remoto ou off-line.
  9. Marque Export files before running build se desejar exportar a origem logo após chamar uma construção remota. Isso permite pular a tarefa de sincronização da origem com o servidor remoto sempre que você desejar executar uma construção remota. Essa opção complementa a opção para trabalhar com um projeto local associado, porque toda a origem no projeto será exportada antes do início da construção.
  10. Clique na guia Environment. Nela, você pode digitar novas variáveis de ambiente ou selecionar variáveis existentes para modificá-las. Para os objetivos dessa tarefa, clique em Select e verifique as duas variáveis para HOST e LOGNAME. Clique em OK.
  11. Clique na guia Common para definir propriedades adicionais para a configuração:
    1. Selecione se deseja que essa configuração seja local para seu workbench ou compartilhada com sua equipe.
    2. Selecione a caixa de opções da barra de ferramentas External Tools, para que a configuração seja exibida como uma favorita (um atalho marcado)
  12. Na parte inferior da caixa de diálogo, clique em Apply para salvar a configuração.
Agora que você criou a configuração, poderá executá-la novamente junto aos recursos remotos em uma única etapa. É possível agora clicar na seta para baixo próxima ao botão da barra de ferramentas de ferramentas externas e selecionar Project Build A . Você também pode selecionar Run > External Tools > Project Build A no menu do workbench:

Essa ação executa a configuração em qualquer um dos recursos remotos selecionados. Para editar a configuração, clique em Run > External Tools > External Tools... novamente e selecione a configuração. Faça todas as modificações e clique em Apply. Você também pode clicar com o botão direito do mouse na configuração e selecionar Duplicate para trabalhar a partir de uma cópia da configuração, para que, por exemplo, possa salvar uma nova configuração que contém uma ou duas variáveis de ambiente diferentes.

Tarefas relacionadas
Trabalhando com Run Launch Configurations
Executando um Programa no Job do Servidor de Comunicação do Remote System Explorer
Executando um Aplicativo Batch
Executando um Aplicativo Interativo
Executando um Aplicativo Multiencadeado
Trabalhando com Configurações de Ativação de Execução para os Programas C e C++ - Apenas Advanced Edition
Trabalhando com Configurações de Ativação de Execução para Programas Java
Depurando Programas Java Remotos
Depurando Programas C e C++ Remotos