release-engineering/dist-git
1
0
Fork 0
mirror of https://github.com/release-engineering/dist-git.git synced 2025-02-23 23:12:55 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Stylistic updates in README.md

Browse source
This commit is contained in:
Adam Samalik 2015-04-17 07:58:59 +02:00
parent f7b5a14045
commit dcd6ee3a9a
1 changed files with 7 additions and 7 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

14
README.md
View file

@ -9,10 +9,10 @@ Dist Git is a remote Git repository specificaly designed to hold RPM package sou
2. Lookaside cache to store source tarballs 2. Lookaside cache to store source tarballs
3. Scripts to manage 3. Scripts to manage
How does it work How Does It Work
---------------- ----------------
### Hosting files ### Hosting Files
An RPM package repository typically consists of a spec file and the sources itself. Sources are most often taken from the upstream as they are and packed as a tarball. The sources can contain large files like virtual machine images, which, in some cases, can grow up to several GB. Those binary files can not be stored in git effectively - so the Dist Git stores them in a separate place called Lookaside Cache and only a text link to the cache is stored in the git itself. An RPM package repository typically consists of a spec file and the sources itself. Sources are most often taken from the upstream as they are and packed as a tarball. The sources can contain large files like virtual machine images, which, in some cases, can grow up to several GB. Those binary files can not be stored in git effectively - so the Dist Git stores them in a separate place called Lookaside Cache and only a text link to the cache is stored in the git itself.
@ -26,7 +26,7 @@ User cat interact with the Dist Git server using client probably based on [rpkg]
![server-communication](/images/server-communication.png) ![server-communication](/images/server-communication.png)
#### Package Database communication #### Package Database Communication
The following is an example JSON data comming from the Package Database which would create two packages: *copr-frontend* and *copr-backend*. The first package would be for Fedora 21 only and permissions to commit into this repo would be granted to users *mirek*, *adam* and anyone in the group *provenpackager*. The *copr-backend* package would be for Fedora 21 and CentOS 7. The permissions would be processed the same way as for the first package. The following is an example JSON data comming from the Package Database which would create two packages: *copr-frontend* and *copr-backend*. The first package would be for Fedora 21 only and permissions to commit into this repo would be granted to users *mirek*, *adam* and anyone in the group *provenpackager*. The *copr-backend* package would be for Fedora 21 and CentOS 7. The permissions would be processed the same way as for the first package.
```JSON ```JSON
@ -78,7 +78,7 @@ Instalation Guide
The project is prepared to be built as an RPM package. You can easily build it on [Fedora](https://getfedora.org/) or [CentOS](https://www.centos.org/) using a tool called [Tito](https://github.com/dgoodwin/tito). The project is prepared to be built as an RPM package. You can easily build it on [Fedora](https://getfedora.org/) or [CentOS](https://www.centos.org/) using a tool called [Tito](https://github.com/dgoodwin/tito).
#### 1. Build and install the package: #### 1. Build and Install the Package:
To build the current release, use the following command in the repo directory: To build the current release, use the following command in the repo directory:
`$ tito build --rpm` `$ tito build --rpm`
@ -100,7 +100,7 @@ Enable the lookaside cache by using and modifying the example httpd scripts:
# vim lookaside-upload.conf # vim lookaside-upload.conf
``` ```
#### 3. Users and groups: #### 3. Users and Groups:
All users need to: All users need to:
1. have an ssh access with private key authentication 1. have an ssh access with private key authentication
@ -119,7 +119,7 @@ mkdir /home/$USER/.ssh
echo "command=\"HOME=/var/lib/dist-git/git/ /usr/share/gitolite3/gitolite-shell $USER $RSA\" > /home/$USER/.ssh/authorized_keys echo "command=\"HOME=/var/lib/dist-git/git/ /usr/share/gitolite3/gitolite-shell $USER $RSA\" > /home/$USER/.ssh/authorized_keys
``` ```
#### 4. Install the web interface: #### 4. Install the Web Interface:
Install Cgit, the web interface for git: Install Cgit, the web interface for git:
`# yum install cgit` `# yum install cgit`
@ -132,7 +132,7 @@ And point it to the distgit repositories:
The web interface will be available on address like `http://your-server/cgit`. The web interface will be available on address like `http://your-server/cgit`.
#### 5. Systemd services: #### 5. Systemd Services:
``` ```
# systemctl start sshd # systemctl start sshd