Commit 1cac2d42b6e450181ce617e5a20d2f61c28a50a1
Committed by
Lucas Kanashiro
1 parent
3d74403b
Exists in
stable-5.1
Adding the package documentation
(cherry picked from commit 3e7c5769f2520b1596432766560c7ad3efb857c4)
Showing
4 changed files
with
111 additions
and
3 deletions
Show diff stats
docs/index.rst.in
docs/manutencao.rst.in
... | ... | @@ -139,17 +139,17 @@ do Nginx `cookbooks/reverse_proxy/templates/reverse_proxy.conf.erb` na variável |
139 | 139 | `client_max_upload_size`. O valor deve ser definido como `<valor>m`. Exemplo |
140 | 140 | `client_max_body_size = 500m` sendo 500m o maior limite entre as ferramentas. |
141 | 141 | |
142 | - **Nota** Ferramenta Gitlab | |
142 | +Nota Ferramenta Gitlab | |
143 | 143 | ------------ |
144 | 144 | |
145 | 145 | Atualmente o SPB está utilizando o Gitlab versão 7.6.2 mantido no repositório |
146 | -de pacotes RPM `Softwarepublico Copr Fedora`_ . O pacote é criado e mantido | |
146 | +de pacotes RPM Softwarepublico `Copr Fedora` . O pacote é criado e mantido | |
147 | 147 | pelo SPB, ou seja, a instancia do Gitlab contém as configurações necessárias |
148 | 148 | para a integração com as ferramenta e ambiente do SPB. Os pacotes de instação |
149 | 149 | providos pelo próprio Gitlab não tem a garantia de funcionamento com o SPB. |
150 | 150 | |
151 | 151 | Há uma atualização do pacote Gitlab v8.5.0 disponível no projeto *eperimental* no |
152 | -mesmo repositório ( `Softwarepublico Copr Fedora`_ ) . O serviço é instanciado | |
152 | +mesmo repositório ( Softwarepublico `Copr Fedora` ) . O serviço é instanciado | |
153 | 153 | e é possível utiliza-lo em *stand alone*. Entretanto não foi realizado a |
154 | 154 | integração e testes do novo pacote com o ambiente e ferramentas do SPB. |
155 | 155 | ... | ... |
... | ... | @@ -0,0 +1,34 @@ |
1 | +Pacotes das Ferramentas | |
2 | +========== | |
3 | + | |
4 | +As ferramentas utilizadas no SPB são mantidas no repositório de pacotes | |
5 | +`Copr Fedora`. Cada projeto contém um conjunto de pacotes RPM para instalação | |
6 | +das ferramentas seguindo uma versão, exemplo, o projeto v4 contém os pacotes | |
7 | +construidos para a versão stable-4.x (versão referente a branch utilizada para | |
8 | +o converge). O projeto experimental contém os pacotes em versão de teste e pode | |
9 | +apresentar instabilidade. | |
10 | + | |
11 | +.. _`Copr Fedora`: https://copr.fedorainfracloud.org/coprs/softwarepublico/ | |
12 | + | |
13 | +Versão | |
14 | +------------ | |
15 | + | |
16 | +Os pacotes são construidos com a utilização dos arquivos specs localizados em | |
17 | +``softwarepublico/src/pkg-rpm/<pacote>/*.spec`` (repositório oficial do Softwarepublico) | |
18 | +e cada pacote contem a sua versão definida pelo atributo ``Version`` | |
19 | +(mais informações sobre pacote RPM `aqui`). | |
20 | + | |
21 | +Para os pacotes *noosfero-spb*, *colab-spb-theme* e *colab-spb-plugin* tem a versão | |
22 | +definida no arquivo VERSION na pasta raíz do repositório oficial do Softwarepublico. | |
23 | +A lógica de criação desses pacotes são definidas no arquivo Makefile em | |
24 | +``softwarepublico/src/Makefile`` e podem ser atualizados utilizando o comando | |
25 | +``make release`` do qual automaticamente realizam o upload do arquivo. | |
26 | + | |
27 | +**Nota**: o arquivo VERSION foi criado ao final da release 4/início da release 5. | |
28 | +A sua primeira versão foi lançada com ``5.0a0``, ou seja, não existe a versão | |
29 | +``4.XaY``, portanto os pacotes referentes a v4 e branch stable-4.X contém os | |
30 | +pacotes com as tags ``5.0a0`` não tendo correlação direta de versão. | |
31 | + | |
32 | +.. _`aqui`: https://fedoraproject.org/wiki/How_to_create_an_RPM_package/pt | |
33 | + | |
34 | + | ... | ... |
... | ... | @@ -0,0 +1,73 @@ |
1 | +# Building Packages | |
2 | + | |
3 | +This path and scripts automates the build and update the packages for SPB project. | |
4 | +It's can be done manually, but we don't recommend. | |
5 | + | |
6 | +## Requirements | |
7 | + | |
8 | +First, this will only works (at least was tested) on a RedHat based system | |
9 | +(Fedora, CentOS, etc). Everything you need to know about packing for the system | |
10 | +is available [here](https://fedoraproject.org/wiki/How_to_create_an_RPM_package/pt) | |
11 | + | |
12 | +Dependency packages | |
13 | + | |
14 | +``` | |
15 | +# yum install @development-tools | |
16 | +# yum install fedora-packager | |
17 | +# yum install copr-cli | |
18 | +# yum install git | |
19 | +``` | |
20 | + | |
21 | +You need a account on [Copr Fedora](https://copr.fedorainfracloud.org) and the api token to | |
22 | +authenticate when upload. Just follow the instruction on the | |
23 | +[API](https://copr.fedorainfracloud.org/api/). | |
24 | + | |
25 | +You need your GPG key in the machine. If you don't have one follow the | |
26 | +instruction [here](https://fedoraproject.org/wiki/Creating_GPG_Keys/pt-br) | |
27 | + | |
28 | +## Usage | |
29 | + | |
30 | +### Make Release | |
31 | + | |
32 | +Make Release are made to build *colab-spb-plugin*, *colab-spb-theme* e | |
33 | +*noosfero-spb*. Bump the VERSION file on the root directory and runs | |
34 | +into the src/ directory: | |
35 | + | |
36 | +``` | |
37 | +$ make release | |
38 | +``` | |
39 | + | |
40 | +Follow the instructions and done :). | |
41 | +Don't forget to push the changes to the repository. | |
42 | + | |
43 | +### Build Packages | |
44 | + | |
45 | +To build the others packages. | |
46 | + | |
47 | +**First**: Build the **tarball** of the | |
48 | +core project. Pay attention to how to build this, some projects needs | |
49 | +requirements or pre-command before create the **tarball**. | |
50 | + | |
51 | +In most of the cases you just needs to run into the project repository: | |
52 | +``` | |
53 | + $ git archive --format=tar.gz --prefix=<pkg-name>-<pkg-version>/ <tag or branch> > <pkg-name>-<pkg-version>.tar.gz | |
54 | + or | |
55 | + $ make sdist | |
56 | +``` | |
57 | + | |
58 | +**Second**: Copy the **tarball** into the pkg-rpm/<project>/ | |
59 | + | |
60 | +**Third**: Runs into the src/pkg-rpm/: | |
61 | +``` | |
62 | + $ make <project>-build | |
63 | + and | |
64 | + $ make <project>-upload | |
65 | +``` | |
66 | + | |
67 | +The first will build the package and the second will upload to | |
68 | +the copr repository using copr-cli. | |
69 | + | |
70 | +**Note**: the copr repository is defined into *src/pkg-rpm/Makefile*. | |
71 | + | |
72 | +**Important**: Make sure that you have all the build dependencies installed. | |
73 | +Just check the .spec file to verify which are. | ... | ... |