Differences

This shows you the differences between two versions of the page.

--- en:centro:servizos:gitlab [2018/05/23 18:03] – created fernando.guillen
+++ en:centro:servizos:gitlab [2018/05/24 14:08] – fernando.guillen
@@ Line 1: / Line 1: @@
-====== Gitlab - Repositorios GIT e integración continua ======
+====== Gitlab - GIT repository and continuous integration ======
-===== Descrición do servizo =====
+===== Service description =====
-Servidor de [[https://www.gitlab.com/|GitLab]], unha ferramenta que permite xestionar repositorios GIT de forma sinxela, moi similar a GitHub.
+[[https://www.gitlab.com/|GitLab]] server, a tool to manage GIT repositories easily, very similar to GitHub.
-Ten activado [[https://about.gitlab.com/gitlab-ci/|GitLab CI]] cun [[https://docs.gitlab.com/runner/executors/docker.html|runner de uso xeral de tipo Docker]] (e a posibilidade de engadir máis runners) e [[https://docs.gitlab.com/ee/user/project/pages/index.html|Gitlab Pages]].
+It has [[https://about.gitlab.com/gitlab-ci/|GitLab CI]] activated with a [[https://docs.gitlab.com/runner/executors/docker.html|Docker runner]] (and the possibility to add more runners) and [[https://docs.gitlab.com/ee/user/project/pages/index.html|Gitlab Pages]].
-===== Alta no servizo =====
+===== Activation =====
-Todos os usuarios do CITIUS poden acceder a este servizo de forma automática.
+All CITIUS users can use this service automatically.
-===== Manual de usuario =====
+===== User manual =====
-==== Acceso a GitLab e primeiros pasos ====
+==== GitLab access and first steps ====
+Go to https://gitlab.citius.usc.es/ and use your CITIUS credentials in the LDAP tab.
-Pódese acceder por https://gitlab.citius.usc.es/. Deberás utilizar o teu usuario e contrasinal do CiTIUS, na pestaña que pon LDAP.
+Once logged in create a new project. Then the steps needed to initialize the repository will be displayed.
-Unha vez dentro, podes crear novos proxectos de forma sinxela. Unha vez creado un proxecto, mostraranse por pantalla os pasos necesarios para inicializar o repositorio.
+Remember that if you choose SSH as the access method (default option), you'll only be capable of doing so from inside the CITIUS network or using the VPN and you'll need to upload a public key in the preferences section. Adding the public key is a simple task and GitLab instructs you on the procedure. This is the recommended choice when working inside the building.
-Recorda que se elixes acceso mediante SSH (a opción por defecto), só poderás facelo dende a rede do centro ou conectado á VPN, e que deberás engadir unha chave pública nas preferencias. Engadir unha chave pública é moi doado, e o propio Gitlab explica como facelo. É a opción recomendada se vas a traballar dende a rede do centro.
+HTTPS access on the other hand works from everywhere and only a valid username and password are needed.
-O acceso mediante HTTPS, pola contra, funciona con usuario e contrasinal, e tamén é accesible dende o exterior.
+[{{ :centro:servizos:gitlab_ssh_https.png?nolink | Clicking the dropdown menu the HTTPS address is shown.}}]
-[{{ :centro:servizos:gitlab_ssh_https.png?nolink |Pulsando no desplegable, podes ver a dirección para acceder mediante HTTPS ao repositorio}}]
 ==== GitLab CI ====
+From version 8.0 onwards Gitlab CI is integrated with Gitlab. To start it is enough to create a file named ''.gitlab-ci.yml'' following the [[http://doc.gitlab.com/ce/ci/quick_start/README.html| Gitlab CI guide]].
-Dende a versión 8.0, Gitlab CI está integrado en Gitlab. Para comezar a usalo, basta con crear un arquivo chamado ''.gitlab-ci.yml'' seguindo a [[http://doc.gitlab.com/ce/ci/quick_start/README.html|guía de Gitlab CI]].
 ==== Gitlab Pages ====
+Pages in Gitlab Pages are served from a ''pages.citius.usc.es'' subdomain (with an alias in ''citiususc.io''), and are created by a Gitlab CI job. There is a basic guide about Gitlab Pages in [[https://pages.citius.usc.es/]] and more information available in [[en:centro:servizos:Aloxamento con Gitlab pages|Gitlab Pages hosting]]
-As páxinas de Gitlab Pages sérvense nun subdominio de ''pages.citius.usc.es'' (cun alias en ''citiususc.io''), e créanse a partir dun traballo de Gitlab CI. Tes unha guía básica sobre o uso de Gitlab Pages en [[https://pages.citius.usc.es/]] e máis información na páxina de [[:centro:servizos:Aloxamento con Gitlab pages|Aloxamento con Gitlab Pages]]
+==== Project creation by groups ====
+Gitlab projects can be created by a user or by a group. If the project implies collaboration with other users or if it may be transferred to other user at some point then it is advisable to create the project in a group. To do so push the //Create a group// button inside the  //Groups// page.
-==== Creación de proxectos en grupos ====
-Os proxectos de GitLab poden crearse dentro dun usuario ou dentro dun grupo. Se o proxecto vai a ser en colaboración con outras persoas, ou é susceptible de ser traspasado a outra persoa unha vez remates o traballo nel, é preferible que cres o proxecto dentro dun grupo. Para facelo, pulsa no botón //Create a group// dentro da páxina de //Groups//.
-==== Arquivos grandes (git lfs) ====
-Os arquivos maiores de 100MB non deben subirse ó repositorio git da forma habitual, senon usando ''git-lfs''. O procedemento é o seguinte:
+==== Big files (git lfs) ====
+Files bigger than 100MB shouldn't be uploaded to the git repository the same way as the others but using ''git-lfs'':
-  - Instalar o cliente de ''git-lfs'', dispoñible no paquete ''git-lfs'' na Ubuntu 14.04 do centro ou [[https://packagecloud.io/github/git-lfs/install|nesta páxina]] para outras distribucións.
+  - Install the ''git-lfs'' client, available in the ''git-lfs'' package in the CITIUS Ubuntu 14.04 or [[https://packagecloud.io/github/git-lfs/install|here]] for other distros.
   - No directorio do repositorio, iniciar o LFS: ''git lfs install''
   - Indicar os arquivos que serán manexados co LFS (poden usarse comodíns): ''git lfs add <nowiki>"*.ova"</nowiki>''