From Fedora Project Wiki
(Atualização para algumas alterações realizadas no documento em inglês.)
m (Atualizações para ficar de acordo com a página principal em inglês)
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 podem carregar seus arquivos para compartilhá-los com o mundo. É perfeito para carregar arquivos .spec, srpms, patches, manter um 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 ==
== 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.
* 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 14: 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, clique em "My Account" na barra lateral.
# Enquanto estiver conectado, clique em "My Account" na barra lateral.
Line 23: Line 25:
# 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 41: Line 43:


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:  


<pre>
<pre>
Line 67: Line 68:


<pre>
<pre>
mkdir repo.git
cd repo.git
git --bare init
git --bare init
touch git-daemon-export-ok
cd ..
scp -r repo.git/ seu_username@fedorapeople.org:~/public_git/
scp -r repo.git/ seu_username@fedorapeople.org:~/public_git/
</pre>
</pre>
Line 79: 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 90: 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 96: 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 126: Line 117:


<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>


Line 168: 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:<usuário>:rwX <repo.git>
find <repo.git> -type d | xargs setfacl -R -m d:u:<usuario>:rwX


[[Category:Infrastructure]]
[[Category:Infrastructure]]

Revision as of 23:35, 2 April 2012

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.

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.

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.

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.


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
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

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.

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

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

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).


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

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.

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


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.


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/


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.


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.


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.


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

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:<usuário>:rwX <repo.git>
find <repo.git> -type d | xargs setfacl -R -m d:u:<usuario>:rwX