From Fedora Project Wiki

Revision as of 23:36, 2 April 2012 by Eldermarco (talk | contribs) (Ajuste estético.)

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