Commit 1cac2d42b6e450181ce617e5a20d2f61c28a50a1

Authored by Paulo Tada
Committed by Lucas Kanashiro
1 parent 3d74403b
Exists in stable-5.1

Adding the package documentation

(cherry picked from commit 3e7c5769f2520b1596432766560c7ad3efb857c4)
docs/index.rst.in
... ... @@ -13,3 +13,4 @@ Software Público Brasileiro: Manual de Operação (@@SPB_ENV@@)
13 13 export_data
14 14 apoio
15 15 busca_global
  16 + pacotes
... ...
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  
... ...
docs/pacotes.rst.in 0 → 100644
... ... @@ -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 +
... ...
src/README.md 0 → 100644
... ... @@ -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.
... ...