Commit b8477f35 authored by Jean-Francois Rey's avatar Jean-Francois Rey
Browse files

up doc

parent 3dca0e01
......@@ -2,7 +2,7 @@
If you want to develop, tests and check your R packages, build R packages binaries under/for Windows automatically, this is the right place.
> Create a VirtualBox under windows 10 with R (Version >= 4.0.0) and Rtools + some dependencies. And register it as a GitLab Runner.
> __Create a VirtualBox under windows 10 with R (Version >= 4.0.0) and Rtools + some dependencies. And register it as a GitLab Runner.__
[[_TOC_]]
......@@ -13,9 +13,9 @@ If you want to develop, tests and check your R packages, build R packages binari
__The main purpose of this project is to automate the creation of a R environment under Windows to use it as a GitLab Runner in CI/CD pipelines.__
Here the steps :
1. Get a VirtualBox Machine from [VagrantCloud](https://app.vagrantup.com/) (a box) under windows 10, generated by [Packer](https://www.packer.io/). More information [here](https://forgemia.inra.fr/gaev/packer/windows10).
2. Initialysing and configuring the VM using [Vagrant](https://www.vagrantup.com/). See [VagrantFile](VagrantFile) template.
3. Provisioning and configuring the VM using [Ansible](https://ww.ansible.com). See [ansible\_provisioning/playbook.yml](ansible\_provisioning/playbook.yml) and scripts in [ansible\_provisioning/files/](ansible\_provisioning/files/) :
1. __Get__ a VirtualBox Machine from [VagrantCloud](https://app.vagrantup.com/) (a box) under windows 10, generated by [Packer](https://www.packer.io/). More information [here](https://forgemia.inra.fr/gaev/packer/windows10).
2. __Initializing__ and configuring the VM using [Vagrant](https://www.vagrantup.com/). See [VagrantFile](VagrantFile) template.
3. __Provisioning__ and configuring the VM using [Ansible](https://ww.ansible.com). See [ansible\_provisioning/playbook.yml](ansible\_provisioning/playbook.yml) and scripts in [ansible\_provisioning/files/](ansible\_provisioning/files/) :
- Update Windows
- Install R (>= 4.0.0)
- Install Rtools (>= Rtools40)
......@@ -25,8 +25,8 @@ Here the steps :
- Install GitLab-Runner for artifacts (lastest version)
- Install MiKTex (lastest version)
- Install Pandoc (2.10.1)
4. Generating a new Vagrant box
5. Registering this new VM as a GitLab Runner (snapshot version)
4. __Generating__ a new Vagrant box
5. __Registering__ this new VM as a GitLab Runner (snapshot version)
## Dependencies
......@@ -71,10 +71,10 @@ tags:
Every things happen in the [.gitlab-ci.xml](.gitlab-ci.xml) file.
Mainly the [VagrantFile](VagrantFile) set up a virtual machine from Vagrant Cloud [GAEV/win10](https://app.vagrantup.com/GAEV/boxes/win10) box (a windows10 professional evaluation version with vbBoxGuestAditions).
Files in [ansible_provisioning/](ansible_provisioning/) are playbooks for Ansible that will install/configure R, Rtools, packages, MiKTeX, Pandoc and GitLab-Runner.
After the Virtual Machine creation and configuration, it registered as a new gitlab-runner (by replacing the existing virtualbox machine "WIN10R4").
Bonus : The VM (box) is save/backup in a OpenStack Object Store [Swift](https://wiki.openstack.org/wiki/Swift).
Mainly the [VagrantFile](VagrantFile) set up a virtual machine from __Vagrant Cloud__ [GAEV/win10](https://app.vagrantup.com/GAEV/boxes/win10) box (a windows10 professional evaluation version with vbBoxGuestAditions).
Files in [ansible_provisioning/](ansible_provisioning/) are playbooks for __Ansible__ that will install/configure R, Rtools, packages, MiKTeX, Pandoc and GitLab-Runner.
After the Virtual Machine creation and configuration, it registered as a new __gitlab-runner__ (by replacing the existing virtualbox machine "WIN10R4").
Bonus : The VM (box) is save/backup in a __OpenStack Object Store__ [Swift](https://wiki.openstack.org/wiki/Swift).
## Locally
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment