m (typo) |
No edit summary |
||
Line 4: | Line 4: | ||
This page covers the details on how to obtain and use your personal | This page covers the details on how to obtain and use your personal | ||
space on [http://fedorapeople.org fedorapeople.org] , | space on [http://fedorapeople.org fedorapeople.org], a site where Fedora | ||
contributors can upload files | contributors can upload files to share with the world. It is | ||
perfect for uploading specfiles, | perfect for uploading specfiles, SRPMs, patches, or personal Git repositories. | ||
== Forbidden contents == | == Forbidden contents == | ||
* Do NOT distribute anything on fedorapeople.org that Fedora itself cannot distribute for legal reasons. Nothing on the [[ForbiddenItems]] list or otherwise non distributable by Fedora. | * Do NOT distribute anything on fedorapeople.org that Fedora itself cannot distribute for legal reasons. Nothing on the [[ForbiddenItems]] list or otherwise non distributable by Fedora. | ||
* Do NOT upload your private | * Do NOT upload your private ssh keys. While the Fedora Infrastructure Team works hard on keeping the servers secure, break ins will happen and private keys uploaded can be downloaded and brute-forced easily. Private .ssh keys found during an audit will be deleted. | ||
== Accessing Your fedorapeople.org Space == | == Accessing Your fedorapeople.org Space == | ||
# You need an active [https://admin.fedoraproject.org/accounts/ Fedora account] | # You need an active [https://admin.fedoraproject.org/accounts/ Fedora account] | ||
# You must be part of at least one group (other than the CLA group) in Fedora account system. If you have not done anything with your account besides | # You must be part of at least one group (other than the CLA group) in the Fedora account system. If you have not done anything with your account besides setting it up and signing the CLA, the one way you can request sufficient access to use the fedorapeople space is by visiting [http://fedorahosted.org/packager-sponsors the packager sponsors Trac instance] and filing a ticket in the "Initial package hosting request" component. | ||
# You need to generate a ssh key (ssh-keygen -t rsa). | # You need to generate a ssh key (ssh-keygen -t rsa). | ||
# Upload | # Upload the ssh key into your Fedora account. To upload, [https://admin.fedoraproject.org/accounts/user/edit visit this link] and select your key file using the ''Public RSA SSH key'' field. Oftentimes, your public key can be found in your home directory under ''.ssh/id_rsa.pub''. The ssh key will become activated an hour after it is uploaded. | ||
# To connect, use the ssh key you uploaded into your Fedora account:<pre>ssh -i ~/.ssh/id_rsa <your_username>@fedorapeople.org</pre> | # To connect, use the ssh key you uploaded into your Fedora account: <pre>ssh -i ~/.ssh/id_rsa <your_username>@fedorapeople.org</pre> | ||
== Common Answers == | == Common Answers == | ||
* Each Fedora contributor has 2000000 KiB (approximately 1954 MiB) of quota-controlled space. | * Each Fedora contributor has 2000000 KiB (approximately 1954 MiB) of quota-controlled space. | ||
* If you run out of space you should | * If you run out of space you should clean up files you don't need. If you cannot clean anything up, you should contact Fedora Infrastructure to raise your quota. | ||
* To make a publicly viewable space, create a <code>public_html</code> directory. | * To make a publicly viewable space, create a <code>public_html</code> directory. | ||
* Fedora people is NOT to be used for development or | * Fedora people is NOT to be used for development or repository creation. Repositories will need to be created elsewhere and uploaded via scp or rsync. | ||
* DO NOT try to use sudo to install packages you "need. | * DO NOT try to use sudo to install packages you "need". Unless you are in the Infrastructure group and have gotten approval from sysadmin-main, extra packages are not to be installed on fedorapeople. | ||
* Upload files using scp, sftp, or rsync. | * Upload files using scp, sftp, or rsync. | ||
{{admon/tip | Using Nautilus | If you use GNOME, visit [[Infrastructure/fedorapeople.org/Connecting_with_Nautilus | this page]] for an easy way to connect to your fedorapeople.org space.}} | {{admon/tip | Using Nautilus | If you use GNOME, visit [[Infrastructure/fedorapeople.org/Connecting_with_Nautilus | this page]] for an easy way to connect to your fedorapeople.org space.}} | ||
Line 51: | Line 43: | ||
* Once uploaded into the | * Once files are uploaded into the user's public_html directory, the files will become available at: http://your_username.fedorapeople.org/. | ||
* Give other users access to read/write/etc files by using extended acls. Read man pages for setfacl and getfacl for adding them to your dirs/files. This gives the user "your_username" read and write access to <code>file</code>: | * Give other users access to read/write/etc files by using extended acls. Read man pages for setfacl and getfacl for adding them to your dirs/files. This gives the user "your_username" read and write access to <code>file</code>: | ||
Line 58: | Line 50: | ||
== fedora people git hosting support == | == fedora people git hosting support == | ||
fedorapeople.org now has support for hosting git repositories | fedorapeople.org now has support for hosting git repositories. This includesaccess via the git:// protocol for anonymous downloads as well as providing the cgit web interface. | ||
Here is a quick rundown of how to get started | Here is a quick rundown of how to get started with git on fedorapeople.org. It assumes that you are already somewhat familiar with git. You might want to take a look at the [[Git quick reference]]. | ||
=== Create a <code>~/public_git</code> directory on fedorapeople.org === | === Create a <code>~/public_git</code> directory on fedorapeople.org === |
Revision as of 18:04, 6 February 2016
fedorapeople.org
This page covers the details on how to obtain and use your personal space on fedorapeople.org, a site where Fedora contributors can upload files to share with the world. It is perfect for uploading specfiles, SRPMs, patches, or personal Git repositories.
Forbidden contents
- Do NOT distribute anything on fedorapeople.org that Fedora itself cannot distribute for legal reasons. Nothing on the ForbiddenItems list or otherwise non distributable by Fedora.
- Do NOT upload your private ssh keys. While the Fedora Infrastructure Team works hard on keeping the servers secure, break ins will happen and private keys uploaded can be downloaded and brute-forced easily. Private .ssh keys found during an audit will be deleted.
Accessing Your fedorapeople.org Space
- You need an active Fedora account
- You must be part of at least one group (other than the CLA group) in the Fedora account system. If you have not done anything with your account besides setting it up and signing the CLA, the one way you can request sufficient access to use the fedorapeople space is by visiting the packager sponsors Trac instance and filing a ticket in the "Initial package hosting request" component.
- You need to generate a ssh key (ssh-keygen -t rsa).
- Upload the ssh key into your Fedora account. To upload, visit this link and select your key file using the Public RSA SSH key field. Oftentimes, your public key can be found in your home directory under .ssh/id_rsa.pub. The ssh key will become activated an hour after it is uploaded.
- To connect, use the ssh key you uploaded into your Fedora account:
ssh -i ~/.ssh/id_rsa <your_username>@fedorapeople.org
Common Answers
- Each Fedora contributor has 2000000 KiB (approximately 1954 MiB) of quota-controlled space.
- If you run out of space you should clean up files you don't need. If you cannot clean anything up, you should contact Fedora Infrastructure to raise your quota.
- To make a publicly viewable space, create a
public_html
directory. - Fedora people is NOT to be used for development or repository creation. Repositories will need to be created elsewhere and uploaded via scp or rsync.
- DO NOT try to use sudo to install packages you "need". Unless you are in the Infrastructure group and have gotten approval from sysadmin-main, extra packages are not to be installed on fedorapeople.
- Upload files using scp, sftp, or rsync.
To copy files from the command line, you can use scp
scp /path/to/file your_username@fedorapeople.org:/home/fedora/your_username/public_html
- Once files are uploaded into the user's public_html directory, the files will become available at: http://your_username.fedorapeople.org/.
- Give other users access to read/write/etc files by using extended acls. Read man pages for setfacl and getfacl for adding them to your dirs/files. This gives the user "your_username" read and write access to
file
:
setfacl -m u:your_username:rw file
fedora people git hosting support
fedorapeople.org now has support for hosting git repositories. This includesaccess via the git:// protocol for anonymous downloads as well as providing the cgit web interface.
Here is a quick rundown of how to get started with git on fedorapeople.org. It assumes that you are already somewhat familiar with git. You might want to take a look at the Git quick reference.
Create a ~/public_git
directory on fedorapeople.org
ssh your_username@fedorapeople.org "mkdir ~/public_git; /sbin/restorecon -Rv ~/public_git"
Creating a new git repository in ~/public_git
As an example, here is one method to create an empty repository on your local system and upload it:
git init --bare repo.git scp -r repo.git/ your_username@fedorapeople.org:~/public_git/
This creates a bare repository (i.e. a repository that has no working directory). It contains just the files that are part of the .git
directory of a non-bare git repository (the kind most users are accustomed to seeing).
Additionally if you wish your repository to show up in the cgit web interface, you must:
touch ~/public_git/yourgitrepo.git/git-daemon-export-ok
For any repositories you wish to appear there by default.
Uploading an existing repository to ~/public_git
If you have an existing repository you want to use on fedorapeople, you can do so easily:
git clone --bare /path/to/local/repo repo.git scp -r repo.git/ your_username@fedorapeople.org:public_git/
The caveats from the previous section apply here as well.
Pushing to your repository
To push changes from a local repository:
cd /path/to/local/repo git remote add fedorapeople your_username@fedorapeople.org:public_git/repo.git git push --mirror fedorapeople
This creates a mirror of your local repository. All of the branches and tags in the local repository will be pushed to the fedorapeople repository.
If you only want to push selected branches, amend the git push
example. For example, to push only your local master branch:
git push fedorapeople master
Cloning your repository
To clone your repository, use a command similar to:
git clone git://fedorapeople.org/~your_username/repo.git
It is also possible to clone your project via the http:// protocol. In order for this to work, you must arrange to have git-update-server-info
run whenever you update your repository. Typically, this is done with a post-update hook script. However, the user home directories on fedorapeople.org are mounted with the noexec option, which prevents the script from running. Instead, you may create a symbolic link to git-update-server-info
in the hooks directory of your repository:
ssh your_username@fedorapeople.org cd ~/public_git/repo.git/hooks ln -svbf $(git --exec-path)/git-update-server-info post-update git update-server-info
You also need to create a link from ~/public_html/git to ~/public_git:
cd ~/public_html ln -svbf ../public_git git
You can clone your repository over http:// with a command similar to:
git clone http://your_username.fedorapeople.org/git/repo.git/
Browsing your project via cgit
You can see your project listed in cgit once the project list updates. This happens hourly.
If you want to give access to your repository to other users you can do this with ACLs.
setfacl -R -m u:<user>:rwX <repo.git> find <repo.git> -type d | xargs setfacl -R -m d:u:<user>:rwX
Enable per-repo upload-archive
If you want to allow your repository to be accessible via git archive --remote
, you will need to set set the following in your repostiory's config file:
[daemon] uploadarch = true