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