Este guia explica como utilizar o ToolsCloud Manager para gerenciar o seu ambiente da ToolsCloud.

A ferramenta ToolsCloud Manager pode ser acessada através da URL <EMPRESA>.toolscloud.net/toolscloud/manager .

Configurando as informações avançadas do ambiente

Na tela principal do ToolsCloud Manager, clique em “Configurações Avançadas”. Na tela que se abrirá você poderá configurar coisas como a forma de envio de email usada pelo Redmine, a memória disponível para o JBoss, entre outras coisas. Todos os campos desta tela possuem ajuda explicando cada um deles.

Verificando o status e reiniciando servidores de aplicação

O ambiente da ToolsCloud utiliza dois servidores de aplicação:

  1. Apache, que controla Redmine, Git e Subversion
  2. JBoss, usado pelo Nexus e Hudson

Clicando na opção “Gerenciamento de Servidores de Aplicação”, na tela principal do ToolsCloud Manager, você tem acesso aos logs destes aplicativos e pode pará-los ou reiniciá-los, se necessário.

Configurando acesso ao Subversion

Por default, nenhum grupo possui permissão de leitura ou escrita em todo o repositório Subversion. Para alterar estas permissões, faça o seguinte:

  1. No ToolsCloud Manager, escolha a opção “Gerenciamento de Acesso ao Subversion”
  2. Na tela seguinte, você verá uma lista das regras de acesso configuradas no sistema. Se quiser adicionar uma nova regra, clique em “Adicionar nova regra de acesso”
  3. No campo “Caminho do Subversion”, coloque o caminho que você deseja restringir o acesso. Por exemplo, se a URL no Subversion do caminho que você quer proteger for https://minhatoolscloud.toolscloud.net/repos/meuProjeto, coloque neste campo “/meuProjeto”. Ou seja, use sempre como caminho o que estiver após a URL base do Subversion, que neste exemplo é https://minhatoolscloud.toolscloud.net/repos . Se você quiser mudar a permissão de todo o repositório, use apenas “/” neste campo. Note que se um usuário tem uma determinada permissão em um diretório pai, ele automaticamente terá a mesma permissão em todos os diretórios filhos. Por exemplo, se um usuário tiver permissão de leitura e escrita no “/” e permissão só de leitura no diretório “/meuProjeto”, valerá a permissão para o diretório “/” e portanto ele poderá escrever no diretório “/meuProjeto”.
  4. Escolha o grupo do LDAP que você quer dar permissão. Por default, só existe um grupo cadastrado, o grupo “employees”, mas você pode criar quantos grupos quiser. Para isso, vá na ferramenta phpldapadmim e crie um novo grupo na subárvore “ou=groups/ou=svn-groups”
  5. Escolha a permissão que quer dar para o grupo: somente leitura ou leitura e escrita.
  6. Clique no botão “Criar”

Você pode também excluir e alterar regras de acesso usando esta mesma interface.

Atenção! As alterações nas permissões de acesso não são imediatas. Aguarde cerca de 10 minutos para as novas regras sejam aplicadas no repositório.

Configurando acesso ao GIT

Para alterar as permissões de acesso ao GIT, faça o seguinte:

  1. No ToolsCloud Manager, escolha a opção “Gerenciamento de Acesso ao GIT”
  2. Na tela seguinte, escolha “Controle de Acesso ao Git”
  3. Na tela seguinte, você verá uma lista das regras de acesso configuradas no sistema. Se quiser adicionar uma nova regra, clique em “Adicionar nova regra de acesso”
  4. No campo “Caminho do GIT”, coloque o caminho que você deseja restringir o acesso. Por exemplo, se a URL no GIT do caminho que você quer proteger for https://minhatoolscloud.toolscloud.net/git/repository.git/meuProjeto, coloque neste campo “/repository.git/meuProjeto”. Ou seja, use sempre como caminho o que estiver após a URL base do GIT, que neste exemplo é https://minhatoolscloud.toolscloud.net/git . Note que se um usuário tem uma determinada permissão em um diretório pai, ele automaticamente terá a mesma permissão em todos os diretórios filhos. Por exemplo, se um usuário tiver permissão de leitura e escrita no “/repository.git” e permissão só de leitura no diretório “/repository.git/meuProjeto”, valerá a permissão para o diretório “/repository.git” e portanto ele poderá escrever no diretório “repository.git/meuProjeto”.
  5. Escolha o grupo do LDAP que você quer dar permissão. Por default, só existe um grupo cadastrado, o grupo “employees”, mas você pode criar quantos grupos quiser. Para isso, vá na ferramenta phpldapadmim e crie um novo grupo na subárvore “ou=groups/ou=git-groups”
  6. Escolha a permissão que quer dar para o grupo: somente leitura ou leitura e escrita.
  7. Clique no botão “Criar”

Você pode também excluir e alterar regras de acesso usando esta mesma interface.

Como criar novos repositórios GIT

Por default, o GIT do seu ambiente já vem com um repositório criado chamado “repository.git”. Você pode criar outros repositórios se quiser. Para isso, faça o seguinte:

  1. No ToolsCloud Manager, escolha a opção “Gerenciamento de Acesso ao GIT”
  2. Na tela seguinte, escolha “Gerenciar Repositórios Git”
  3. Clique na opção “Adicionar Repositório”
  4. Na tela seguinte, dê um nome para o seu repositório. Como este nome será o nome do diretório que está criado, use um nome sem caracteres especiais ou espaços. Opcionalmente, coloque uma descrição para o repositório também.
  5. Clique em “Criar”

Você pode também excluir um repositório e alterar a sua descrição usando esta mesma interface.

ATENÇÃO! Se você excluir um repositório, você irá excluir irreversivelmente todos os dados contidos nele. Use essa operação com muito cuidado.