Infrastructure/fedorapeople.org/pt-br

From FedoraProject

< Infrastructure | fedorapeople.org(Difference between revisions)
Jump to: navigation, search
(Initial Translation)
 
m (Ajuste estético.)
 
(3 intermediate revisions by one user not shown)
Line 3: Line 3:
 
= fedorapeople.org =
 
= fedorapeople.org =
  
Esta página cobre os detalhes como obter e utilizar o seu espaço pessoal no [http://fedorapeople.org fedorapeople.org], que é um site onde os colaboradores do Fedora pode carregar seus arquivos para compartilhá-los com o mundo. É perfeito para carregar arquivos .spec, srpms, patches, repositório pessoal etc, etc.
+
Esta página cobre os detalhes de como obter e utilizar o seu espaço pessoal no [http://fedorapeople.org fedorapeople.org], que é um site onde os colaboradores do Fedora podem carregar seus arquivos para compartilhá-los com o mundo. É perfeito para carregar arquivos .spec, srpms, patches, manter um repositório pessoal etc, etc.
 +
 
 +
== Conteúdo permitido ==
 +
 
 +
* Por favor, não distribua qualquer coisa no fedorapeople.org que não possa ser distribuída no próprio Fedora por razões legais. Nada que esteja na lista [http://fedoraproject.org/wiki/ForbiddenItems Itens proibidos] ou qualquer outra coisa que não seria distribuída pelo Fedora.
 +
 
 +
* Não carregue sua chave SSH privada. O Projeto Fedora trabalha duro para manter os servidores seguros, mas invasões podem acontecer e suas chaves privadas poderão ser baixadas. Qualquer chave SSH privada encontrada durante a auditoria será excluída.
  
 
== Acessando o seu espaço no fedorapeople.org ==
 
== Acessando o seu espaço no fedorapeople.org ==
Line 10: Line 16:
 
# Deve estar patrocinado por um grupo (além dos grupos CLA)
 
# Deve estar patrocinado por um grupo (além dos grupos CLA)
 
# Precisa gerar uma chave ssh (ssh-keygen -t rsa).
 
# Precisa gerar uma chave ssh (ssh-keygen -t rsa).
# Faça um upload da sua chave ssh para a sua conta Fedora. Para carregá-la para a sua conta, [https://admin.fedoraproject.org/accounts/user/edit visite este link ] e selecione o arquivo referente a sua chave utilizando o campo ''Public RSA SSH Key''. Normalmente, sua chave é armazenada no seu diretório de usuário em ''.ssh/id_rsa.pub''. A chave ssh é ativada cerca de uma hora depois de você carregá-la.  
+
# Faça um upload da sua chave ssh pública para a sua conta Fedora. Para carregá-la para a sua conta, [https://admin.fedoraproject.org/accounts/user/edit visite este link ] e selecione o arquivo referente a sua chave utilizando o campo ''Public RSA SSH Key''. Normalmente, sua chave é armazenada no seu diretório de usuário em ''.ssh/id_rsa.pub''. A chave ssh é ativada cerca de uma hora depois de você carregá-la.  
 
# Para se conectar, use a chave ssh que você carregou para sua conta Fedora:<pre>ssh -i ~/.ssh/id_rsa <seu_username>@fedorapeople.org</pre>
 
# Para se conectar, use a chave ssh que você carregou para sua conta Fedora:<pre>ssh -i ~/.ssh/id_rsa <seu_username>@fedorapeople.org</pre>
  
Esta etapa pode também ser realizada via [https://admin.fedoraproject.org/accounts/ conta Fedora]  
+
Esta etapa pode também ser realizada pelo [https://admin.fedoraproject.org/accounts/ sistema de contas do Fedora]  
  
# Enquanto estiver conectado, click em "My Account" na barra lateral.
+
# Enquanto estiver conectado, clique em "My Account" na barra lateral.
 
# Selecione o link "edit" próximo à "Account Details."
 
# Selecione o link "edit" próximo à "Account Details."
 
# Coloque o seguinte no campo "Public RSA SSH Key":<pre>~/.ssh/id_rsa.pub</pre>
 
# Coloque o seguinte no campo "Public RSA SSH Key":<pre>~/.ssh/id_rsa.pub</pre>
 
# Clique no botão "Save!".
 
# Clique no botão "Save!".
# Verifique se ocorreu tudo com sucesso. Você deverá ver um "ssh-rsa" seguido por uma string alfanumérica no campo "Public SSH Key:" do detalhes da sua conta.
+
# Verifique se ocorreu tudo com sucesso. Você deverá ver um "ssh-rsa" seguido por uma string alfanumérica no campo "Public SSH Key:" dos detalhes da sua conta.
  
 
== Respostas frequentes ==
 
== Respostas frequentes ==
Line 26: Line 32:
 
* Se você exceder esse espaço deverá: apagar coisas que você não mais precisa. Caso você não possa apagá-las, entre em contato com a infraestrutura do fedora para aumentar sua quota de disco.
 
* Se você exceder esse espaço deverá: apagar coisas que você não mais precisa. Caso você não possa apagá-las, entre em contato com a infraestrutura do fedora para aumentar sua quota de disco.
 
* Para tornar seu espaço visível, crie um diretório <code>public_html</code>.
 
* Para tornar seu espaço visível, crie um diretório <code>public_html</code>.
 +
* O Fedora People NÃO é para ser usado para desenvolvimento ou para a criação de repositórios. Os repositórios necessitam ser criados em outro lugar e carregados via scp ou rsync.
 +
* NÃO tente utilizar o sudo para instalar pacotes que você "necessita". A menos que faça parte do grupo de Infraestrutura, e tenha sido aprovado por um administrador principal, os pacotes extras não serão instalados no fedorapeople.
 
* Carregue os arquivos utilizando  scp, sftp ou rsync.
 
* Carregue os arquivos utilizando  scp, sftp ou rsync.
 +
  
 
{{admon/tip | Utilizando o Nautilus | Se você usa o GNOME, visite [[Infrastructure/fedorapeople.org/Connecting_with_Nautilus | esta página]] para  saber uma maneira simples de se conectar ao seu espaço no fedorapeople.org}}
 
{{admon/tip | Utilizando o Nautilus | Se você usa o GNOME, visite [[Infrastructure/fedorapeople.org/Connecting_with_Nautilus | esta página]] para  saber uma maneira simples de se conectar ao seu espaço no fedorapeople.org}}
  
 
{{admon/tip | Utilizando o Dolphin ou Konqueror | Se você utiliza o KDE, digite <code>sftp://seu_username@fedorapeople.org</code> na barra de endereços do seu gerenciador de arquivos para uma maneira fácil de se conectar ao seu espaço no fedorapeople.org.}}
 
{{admon/tip | Utilizando o Dolphin ou Konqueror | Se você utiliza o KDE, digite <code>sftp://seu_username@fedorapeople.org</code> na barra de endereços do seu gerenciador de arquivos para uma maneira fácil de se conectar ao seu espaço no fedorapeople.org.}}
 +
  
 
Para copiar arquivos a partir da linha de comando, você pode usar o scp:  
 
Para copiar arquivos a partir da linha de comando, você pode usar o scp:  
Line 58: Line 68:
  
 
<pre>
 
<pre>
mkdir repo.git
 
cd repo.git
 
 
git --bare init
 
git --bare init
touch git-daemon-export-ok
+
scp -r repo.git/ seu_username@fedorapeople.org:~/public_git/
cd ..
+
scp -r repo.git/ seu_username@fedorapeople.org:public_git/
+
 
</pre>
 
</pre>
  
Line 70: Line 76:
  
 
{{admon/important|O nome do repositório deve terminar com .git| O gitweb não irá listar repositórios que não terminem com <code>.git</code>.|}}
 
{{admon/important|O nome do repositório deve terminar com .git| O gitweb não irá listar repositórios que não terminem com <code>.git</code>.|}}
 
{{admon/important|Acesso ao repositório e o git-daemon-export-ok|Sem o arquivo <code>git-daemon-export-ok</code>, seu repositório não estará disponível de forma anônima via protocolo <code>git://</code>.}}
 
 
{{admon/caution|Repositórios não vazios|Repositórios não vazios ''devem'' funcionar, mas [http://git.or.cz/gitwiki/GitFaq#git-push%20non-bare geralmente é desencorajado] fazer um push dele para o servidor remoto. Entretanto, se você já está com um repositório não vazio, deverá colocar o arquivo git-daemon-export-ok na raiz do diretório git, isto é, em <code>~/public_git/seu_repo.git/git-daemon-export-ok</code>, '''NÃO''' em <code>~/public_git/your_repo.git/.git/git-daemon-export-ok</code>}}
 
  
 
=== Carregando um repositório existente para o <code>~/public_git</code> ===
 
=== Carregando um repositório existente para o <code>~/public_git</code> ===
Line 81: Line 83:
 
<pre>
 
<pre>
 
git clone --bare /caminho/para/seu/repo/local repo.git
 
git clone --bare /caminho/para/seu/repo/local repo.git
touch repo.git/git-daemon-export-ok
 
 
scp -r repo.git/ seu_username@fedorapeople.org:public_git/
 
scp -r repo.git/ seu_username@fedorapeople.org:public_git/
 
</pre>
 
</pre>
Line 87: Line 88:
 
As advertências da seção anterior também se aplicam aqui.
 
As advertências da seção anterior também se aplicam aqui.
  
 
+
=== Realizando um 'push' em seu repositório ===
=== Realizando um push em seu repositório ===
+
  
 
Para realizar um push nas modificações feitas a partir de um repositório local:
 
Para realizar um push nas modificações feitas a partir de um repositório local:
Line 114: Line 114:
 
<pre>git clone git://fedorapeople.org/~seu_username/repo.git</pre>
 
<pre>git clone git://fedorapeople.org/~seu_username/repo.git</pre>
  
É possível também clonar seu projeto através do protocolo http://. Para que isso funcione, você deve fazer com que o <code>git-update-server-info</code> seja executado sempre que você atualizar o seu repositório. Normalmente, isto é feito com um script de pós-atualização. Entretanto, o diretório dos usuários no fedorapeople.org são montados com a opção noexec, o que impede a execução do script. Em vez disso, você pode criar um link simbólico para o <code>git-update-server-info</code> no diretório do seu repositório.
+
É possível também clonar seu projeto através do protocolo http://. Para que isso funcione, você deve fazer com que o <code>git-update-server-info</code> seja executado sempre que você atualizar o seu repositório. Normalmente, isto é feito com um script de pós-atualização. Entretanto, o diretório dos usuários no fedorapeople.org são montados com a opção noexec, o que impede a execução do script. Em vez disso, você pode criar um link simbólico para o <code>git-update-server-info</code> no diretório do seu repositório:
  
 
<pre>
 
<pre>
ssh ~seu_username@fedorapeople.org
+
ssh seu_username@fedorapeople.org
 
cd ~/public_git/repo.git/hooks
 
cd ~/public_git/repo.git/hooks
ln -svbf /usr/bin/git-update-server-info post-update
+
ln -svbf $(git --exec-path)/git-update-server-info post-update
 +
git update-server-info
 
</pre>
 
</pre>
  
Você também precisa criar olink ~/public_html/git que aponta para ~/public_git:
+
Você também precisa criar o link ~/public_html/git que aponta para ~/public_git:
 
<pre>
 
<pre>
 
cd ~/public_html
 
cd ~/public_html
Line 138: Line 139:
 
=== Navegando no seu projeto via gitweb ===
 
=== Navegando no seu projeto via gitweb ===
  
Você pode ver o seu projeto listado no [http://fedorapeople.org/gitweb gitweb] na lista de atualização de projetos. isto acontece a cada hora. ''Note que a URL no gitweb pode mudar.''
+
Você pode ver o seu projeto listado no [http://fedorapeople.org/gitweb gitweb] na lista de atualização de projetos. Isto acontece a cada hora. ''Note que a URL no gitweb pode mudar.''
  
  
Line 144: Line 145:
  
  
{{admon/tip|URLs do repositório|Os URLs do gitweb exibidos para o seu repositório são incorretos por padrão (desde que o serviço foi criado em meados de 2008.  Ultima verificação em 11/08/2010). Você pode contornar isso adicionando o arquivo <code>cloneurl</code> ao seu repositório contendo as URLs corretas:
+
{{admon/tip|URLs do repositório|Os URLs do gitweb exibidos para o seu repositório são incorretos por padrão (desde que o serviço foi criado em meados de 2008.  Última verificação em 11/08/2010). Você pode contornar isso adicionando o arquivo <code>cloneurl</code> ao seu repositório contendo as URLs corretas:
  
 
URLs padrão incorretas:
 
URLs padrão incorretas:
Line 159: Line 160:
  
 
}}
 
}}
 +
 +
=== Repositório compartilhado ===
 +
Caso queira permitir que outros usuários acessem seu repositório, você pode fazê-lo com as ACLs
 +
 +
setfacl -R -m u:<usuario>:rwX <repo.git>
 +
find <repo.git> -type d | xargs setfacl -R -m d:u:<usuario>:rwX
 +
  
 
[[Category:Infrastructure]]
 
[[Category:Infrastructure]]

Latest revision as of 23:36, 2 April 2012

Contents

[edit] fedorapeople.org

Esta página cobre os detalhes de como obter e utilizar o seu espaço pessoal no fedorapeople.org, que é um site onde os colaboradores do Fedora podem carregar seus arquivos para compartilhá-los com o mundo. É perfeito para carregar arquivos .spec, srpms, patches, manter um repositório pessoal etc, etc.

[edit] Conteúdo permitido

  • Por favor, não distribua qualquer coisa no fedorapeople.org que não possa ser distribuída no próprio Fedora por razões legais. Nada que esteja na lista Itens proibidos ou qualquer outra coisa que não seria distribuída pelo Fedora.
  • Não carregue sua chave SSH privada. O Projeto Fedora trabalha duro para manter os servidores seguros, mas invasões podem acontecer e suas chaves privadas poderão ser baixadas. Qualquer chave SSH privada encontrada durante a auditoria será excluída.

[edit] Acessando o seu espaço no fedorapeople.org

  1. Você precisa de uma conta Fedora.
  2. Deve estar patrocinado por um grupo (além dos grupos CLA)
  3. Precisa gerar uma chave ssh (ssh-keygen -t rsa).
  4. Faça um upload da sua chave ssh pública para a sua conta Fedora. Para carregá-la para a sua conta, visite este link e selecione o arquivo referente a sua chave utilizando o campo Public RSA SSH Key. Normalmente, sua chave é armazenada no seu diretório de usuário em .ssh/id_rsa.pub. A chave ssh é ativada cerca de uma hora depois de você carregá-la.
  5. Para se conectar, use a chave ssh que você carregou para sua conta Fedora:
    ssh -i ~/.ssh/id_rsa <seu_username>@fedorapeople.org

Esta etapa pode também ser realizada pelo sistema de contas do Fedora

  1. Enquanto estiver conectado, clique em "My Account" na barra lateral.
  2. Selecione o link "edit" próximo à "Account Details."
  3. Coloque o seguinte no campo "Public RSA SSH Key":
    ~/.ssh/id_rsa.pub
  4. Clique no botão "Save!".
  5. Verifique se ocorreu tudo com sucesso. Você deverá ver um "ssh-rsa" seguido por uma string alfanumérica no campo "Public SSH Key:" dos detalhes da sua conta.

[edit] Respostas frequentes

  • Cada colaborador Fedora tem 2000000 KB (aproximadamente 1954 MB) de espaço em disco.
  • Se você exceder esse espaço deverá: apagar coisas que você não mais precisa. Caso você não possa apagá-las, entre em contato com a infraestrutura do fedora para aumentar sua quota de disco.
  • Para tornar seu espaço visível, crie um diretório public_html.
  • O Fedora People NÃO é para ser usado para desenvolvimento ou para a criação de repositórios. Os repositórios necessitam ser criados em outro lugar e carregados via scp ou rsync.
  • NÃO tente utilizar o sudo para instalar pacotes que você "necessita". A menos que faça parte do grupo de Infraestrutura, e tenha sido aprovado por um administrador principal, os pacotes extras não serão instalados no fedorapeople.
  • Carregue os arquivos utilizando scp, sftp ou rsync.


Idea.png
Utilizando o Nautilus
Se você usa o GNOME, visite esta página para saber uma maneira simples de se conectar ao seu espaço no fedorapeople.org
Idea.png
Utilizando o Dolphin ou Konqueror
Se você utiliza o KDE, digite sftp://seu_username@fedorapeople.org na barra de endereços do seu gerenciador de arquivos para uma maneira fácil de se conectar ao seu espaço no fedorapeople.org.


Para copiar arquivos a partir da linha de comando, você pode usar o scp:

scp /caminho/para/o/arquivo seu_username@fedorapeople.org:/home/fedora/seu_username/public_html
  • Uma vez carregado no diretório public_html, os arquivos ficam disponíveis em http://seu_username.fedorapeople.org.
  • Dar acesso de leitura/escrita/etc a outros usuários usando as acls estendidas. Leia as man pages do setfacl e do getfacl para maiores detalhes de como fazê-lo aos seus diretórios/arquivos. Isto dá ao usuário jkeating acesso de leitura e escrita para o arquivo arquivo:
setfacl -m u:jkeating:rw arquivo

[edit] Suporte a hospedagem git (BETA)

O fedorapeople.org agora tem suporte a repositórios git incluindo o acesso via protocolo git:// para downloads anônimos bem como através do gitweb. Isto deve ser considerado beta.

Aqui está um rápido resumo de como começar a utilizar o git no fedorapeople.org. Ele assume que você já está um pouco familiarizado com o git, mas você pode querer dar uma olhada no Git - referência rápida.

[edit] Criar o diretório ~/public_git no fedorapeople.org

ssh seu_username@fedorapeople.org "mkdir ~/public_git"

[edit] Criando um novo repositório git em ~/public_git

Como exemplo, eis um método para criar um repositório vazio no seu sistema local e depois fazer o upload dele:

git --bare init
scp -r repo.git/ seu_username@fedorapeople.org:~/public_git/

Isto cria um repositório vazio (isto é, um repositório sem um diretório de trabalho). Ele contém apenas os arquivos que são parte do diretório .git de um repositório comum do git (do tipo que a maioria dos usuários estão acostumados a ver).


Important.png
O nome do repositório deve terminar com .git
O gitweb não irá listar repositórios que não terminem com .git.

[edit] Carregando um repositório existente para o ~/public_git

Se você já tiver um repositório e quiser utilizá-lo no fedorapeople, pode fazê-lo facilmente:

git clone --bare /caminho/para/seu/repo/local repo.git
scp -r repo.git/ seu_username@fedorapeople.org:public_git/

As advertências da seção anterior também se aplicam aqui.

[edit] Realizando um 'push' em seu repositório

Para realizar um push nas modificações feitas a partir de um repositório local:

cd /caminho/para/seu/repo/local
git remote add fedorapeople your_fedora_username@fedorapeople.org:public_git/repo.git
git push --mirror fedorapeople

Isto cria um espelho do seu repositório local. Todos os branches e tags no repositório local serão enviados para o seu repositório no fedorapeople.

Se você quer realizar um push apenas de alguns branches, altere o exemplo abaixo com o git push. Por exemplo, para realizar um push somente do seu branch master local:

git push fedorapeople master


Idea.png
Permitindo que outros realizem um push
Você pode permitir que outros usuários do fedorapeople.org realizem um push no seu repositório usando as acls estendidas (veja setfacl(1) para maiores detalhes). Entretanto, se existem muitos trabalhando no seu projeto, o uso do Fedora Hosted é altamente encorajado.


[edit] Clonando seu repositório

Para clonar seu repositório, utilize um comando similar a:

git clone git://fedorapeople.org/~seu_username/repo.git

É possível também clonar seu projeto através do protocolo http://. Para que isso funcione, você deve fazer com que o git-update-server-info seja executado sempre que você atualizar o seu repositório. Normalmente, isto é feito com um script de pós-atualização. Entretanto, o diretório dos usuários no fedorapeople.org são montados com a opção noexec, o que impede a execução do script. Em vez disso, você pode criar um link simbólico para o git-update-server-info no diretório do seu repositório:

ssh seu_username@fedorapeople.org
cd ~/public_git/repo.git/hooks
ln -svbf $(git --exec-path)/git-update-server-info post-update
git update-server-info

Você também precisa criar o link ~/public_html/git que aponta para ~/public_git:

cd ~/public_html
ln -svbf ../public_git git

Você pode clonar seu repositório a partir do protocolo http:// com um comando similar a:

git clone http://seu_username.fedorapeople.org/git/repo.git/


Idea.png
git:// versus http://
Apenas clone via http:// se você estiver atrás de um firewall que impede que o protocolo git:// funcione. O protocolo git:// é mais rápido e mais eficiente do que o protocolo http:// para uso com o git.


[edit] Navegando no seu projeto via gitweb

Você pode ver o seu projeto listado no gitweb na lista de atualização de projetos. Isto acontece a cada hora. Note que a URL no gitweb pode mudar.


Idea.png
Descrição do repositório
Você pode mudar a descrição do repositório que é exibida no gitweb editando o arquivo description no seu repositório.


Idea.png
URLs do repositório
Os URLs do gitweb exibidos para o seu repositório são incorretos por padrão (desde que o serviço foi criado em meados de 2008. Última verificação em 11/08/2010). Você pode contornar isso adicionando o arquivo cloneurl ao seu repositório contendo as URLs corretas:

URLs padrão incorretas:

git://fedorapeople.org/home/fedora/seu_username/public_git/repo.git
ssh://fedorapeople.org/home/fedora/seu_username/public_git/repo.git

Escreva essas URLs no arquivo cloneurl para contornar isso:

git://fedorapeople.org/~seu_username/repo.git
ssh://fedorapeople.org/~seu_username/public_git/repo.git

[edit] Repositório compartilhado

Caso queira permitir que outros usuários acessem seu repositório, você pode fazê-lo com as ACLs

setfacl -R -m u:<usuario>:rwX <repo.git>
find <repo.git> -type d | xargs setfacl -R -m d:u:<usuario>:rwX