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
- Você precisa de uma conta Fedora.
- Deve estar patrocinado por um grupo (além dos grupos CLA)
- Precisa gerar uma chave ssh (ssh-keygen -t rsa).
- 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.
- 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
- Enquanto estiver conectado, clique em "My Account" na barra lateral.
- Selecione o link "edit" próximo à "Account Details."
- Coloque o seguinte no campo "Public RSA SSH Key":
~/.ssh/id_rsa.pub
- 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:" 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.
Se você usa o GNOME, visite esta página para saber uma maneira simples de se conectar ao seu espaço no fedorapeople.org
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 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
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/
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.
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.
Você pode mudar a descrição do repositório que é exibida no gitweb editando o arquivo
description no seu 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