Commit Graph

49 Commits

Author SHA1 Message Date
Marc Mattmüller 1ef66cc7c8 doc: added status and migration work after review
Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-09-19 16:09:13 +02:00
Marc Mattmüller 8942501294 doc: update with review part
Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-09-18 16:52:00 +02:00
Marc Mattmüller aa1e58f58c docker: integrate nginx credentials for docker-compose instance
The ansible instance is set up using ansible. The nginx credentials
were missing which let the sync of the sstate-cache mirror fail.
Thus, adapting the environment by adding the credentials.
Including the update of the documentation

Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-09-12 14:38:48 +02:00
Marc Mattmüller 8561fe8df1 doc/nwl-ci: updated with latest fixed, changes and findings
Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-09-11 13:39:19 +02:00
Marc Mattmüller d384814fb3 doc/researchAnsible: fixed some typos
Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-09-05 14:58:55 +02:00
Marc Mattmüller 2a85c3ae25 doc/nwl-ci: added documentation about creating PR for src rev update
Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-09-05 14:58:22 +02:00
Marc Mattmüller 3ff3dc9435 doc/nwl-ci: added update src rev part, branch seeding and nightly trigger
Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-09-04 12:29:51 +02:00
Marc Mattmüller 3364307149 doc/nwl-ci: updated sections about integrating seed job in NWL HAC instance
On the ansible instance we saw that the seed job concept was working.
To be as felxible as possible as well on the HAC instance this
concept shall be integrated into this instance. Therefore this commit
holds all the steps so that the yocto build pipeline is starting to
build.
NOTE: currently the NWL project is in progress and the build is not
succeeding.

Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-08-28 18:22:42 +02:00
Marc Mattmüller 7937b4bac7 doc/researchAnsible: updated due to enhancement of adding variable target
Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-08-21 16:50:36 +02:00
Marc Mattmüller 64c24ccfcb doc/nwl-ci: added setup of hash equivalence server
Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-08-21 11:28:21 +02:00
Marc Mattmüller 450082c366 doc/nwl-ci: fixed server path of sstate-cache mirror
Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-08-01 11:01:35 +02:00
Marc Mattmüller c50ff430a1 doc/nwl-ci: added change of manage script for an additional ssh key
to have the ssh key of nginx available in the docker instance, the
manage script needed to be adapted as each key was added with a
single mount command.

Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-08-01 10:59:36 +02:00
Marc Mattmüller a734db2932 doc/nwl-ci: documented adaptions for sstate-cache mirror and job split
Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-07-31 18:07:36 +02:00
Marc Mattmüller cd76fd0385 doc/researchAnsible: comparisson of kubernetes tools and added K3s setup
There are different kubernetes tools. This commit holds a table with a
comparisson of the different tools.
Additionally a K3s instance was set up and documented.

Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-07-24 16:52:00 +02:00
Marc Mattmüller 3471acdf6d docs/researchAnsible: added section about jenkins plugin versions
the plugin versions are as important as the jenkins version.
One could update the plugins via Jenkins UI and with that you
might loose the control of versions in case of a rebuilt for an
already released software. Thus, this section was added and we
need to integrate the versions as well.

Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-07-18 16:24:54 +02:00
Marc Mattmüller 916f82d764 doc/researchAnsible: reformatting a paragraph
Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-07-18 13:32:05 +02:00
Marc Mattmüller c33d1b0b18 doc: added section about further research concerning host selection
With this commit the investigations regarding running a playbook
on specific host(s) are documented.

There are different host selection possibilities like limitation,
providing an inventory with only one host (command line), using
the playbook keyword 'when' or by providing a variable for the
playbook keyword 'hosts'.

This part is important if it comes to an ochestration of hosts
with different running and setup states.

Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-07-18 13:05:06 +02:00
Marc Mattmüller 69cacceb4d doc/nextlevel-ci: added snippet to install a GitLab runner
To use the GitLab CI on a project, a server needs to install a
runner. The NetModule Know-How documentation holds already an
instruction guide about how to set up such a runner. For
completness a short summary is added to the next-level CI page.

Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-07-17 08:02:03 +02:00
Marc Mattmüller 5e4f2fd812 doc/nextlevel-ci: updated ansible template overview
Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-07-17 06:30:55 +02:00
Marc Mattmüller a41e82830e doc/researchAnsible: added note about changed playbooks with truststore setup
Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-07-11 16:59:30 +02:00
Marc Mattmüller f6c4371aab doc,docker/nwl-cicd: added docu about triggering jobs over web API
Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-07-11 14:32:53 +02:00
Marc Mattmüller 7d9c9f15a8 doc/researchAnsible: added section about nexus upload and rootCA
Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-07-11 14:01:55 +02:00
Marc Mattmüller c0aa819f5f doc/researchAnsible: added part for job seeding
Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-07-07 16:21:20 +02:00
Marc Mattmüller 206540d8b9 doc: added the latest part of Job seeding
Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-06-27 17:22:36 +02:00
Marc Mattmüller 2b7d4eac13 doc: added CI workflow proposal
there is a need of standardization and flexibility for project
specific parts. Thus, a new section is added where the ansible
work shows how to bring that into a standardized workflow.

Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-06-27 11:34:34 +02:00
Marc Mattmüller 96889165d5 doc/researchAnsible: adding hint about nexus upload issue
Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-06-26 17:52:14 +02:00
Marc Mattmüller 758802aadd doc/researchAnsible: integrated some details more
added the hint that we use the already available declarative
pipeline of NWL which is running on the HAC instance.

Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-06-26 16:51:58 +02:00
Marc Mattmüller e6498fdf11 doc/nextlevel-ci: rephrased sentence to make it more understandable
Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-06-26 16:29:55 +02:00
Marc Mattmüller de938eb977 doc: added author to index page
Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-06-26 16:21:49 +02:00
Marc Mattmüller da03d0f163 doc/researchAnsible: documentated jenkins bring-up and conclusion
This commit holds now all the documentation to bring up a jenkins
instance using ansible and AWX.

Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-06-26 15:46:38 +02:00
Marc Mattmüller 091f8f8e0d doc/researchAnsible: documented the work to setup and start a Jenkins
The topic Jcasc was already handled. With this commit we are able to
setup a Jenkins by using docker-compose.

Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-06-21 12:51:40 +02:00
Marc Mattmüller 4f35879604 doc/researchAnsible: added note about nexus repo configuration
Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-06-21 09:18:20 +02:00
Marc Mattmüller 8e54299b58 doc/nwl-ci: added documentation with nexus artifact uploader
Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-06-19 20:56:15 +02:00
Marc Mattmüller 974b77234d doc/researchAnsible: added sections build docker image and conclusion
With this commit we set up a machine until building a docker image on
it. The next step would be to start the docker container or the
docker compound.

It is as well possible to run the playbooks without having an AWX
instance but AWX gives you more overview about the things that are
available and happening. E.g. you can set up schedules for re-
occurring jobs. For reasons of completness an example to launch
a playbook from command line is added in the conclusion section.

Additionally I added a section about combining playbooks in one
common playbook which might be useful to have really a single
button press for setting up a new machine.

Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-06-13 14:12:19 +02:00
Marc Mattmüller 1960187318 doc/researchAnsible: added section to clone a git repository
AWX uses separate ssh keys to access the host. The host itself uses
its own ssh keys to access bitbucket. The added section shows a way
how to handle such a condition.

Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-06-13 11:52:58 +02:00
Marc Mattmüller 262c560f38 doc/researchAnsible: added snippet reconfiguring docker network
Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-06-13 11:51:22 +02:00
Marc Mattmüller ef3fd030ba doc/ciWithinBitbucket: added link to keep in mind
Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-06-06 14:29:16 +02:00
Marc Mattmüller 4a7633f845 doc/researchAnsible: added section for creating ssh keypairs
Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-06-06 14:28:39 +02:00
Marc Mattmüller 70d033bde7 doc: added the installed Jenkins plugins on the NWL instance
additionally, I added the ones which are installed on the
NetModule Jenkins instance.

Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-06-05 13:23:50 +02:00
Marc Mattmüller c304cf9954 doc: added new chapter with title CI within Bitbucket
the topic about using the Git server (Bitbucket or GitLab) for
user-space applications has driven me into that direction.
Unfortunately there is a lack of information and permission to
move on with this topic. Thus, I postponed it until I get some
news :-)

Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-06-05 13:18:49 +02:00
Marc Mattmüller a9a720a364 doc: added CI use-cases
visualized the different use-cases for the CI environment
including the TDD workflow.

Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-05-30 16:53:20 +02:00
Marc Mattmüller ae29034593 doc/researchAnsible: added part about basic pkg installation with sudo
Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-05-16 14:22:12 +02:00
Marc Mattmüller 9e6a6d7c8d doc/researchAnsible: added job template for getting started playbook
Documented the job template to get the information residing in
the playbook getting_started/os-rls.yml

Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-05-15 09:56:19 +02:00
Marc Mattmüller c22a7a2f38 doc/researchAnsible: added sections for project and inventories
this commit holds the information about how to synchronize a git
project containing ansible playbooks and hosts with AWX.

NOTE: getting the hosts of the inventroy file is not that obvious,
      hence it is worth to read it.

Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-05-15 09:56:13 +02:00
Marc Mattmüller cc1c338e09 researchAnsible: updated with setup of latest AWX version
The latest version of AWX requires a Kubernetes Cluster. This
commit holds the update of the page and shows both installation
methodes (directly with docker and the latest version with a
minikube).

Additionally, I added a new section setting up a virtual machine
for test purpose. With it another section for accessing such
machines over SSH.

Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-05-09 12:25:16 +02:00
Marc Mattmüller 740a647460 doc,ansible: documented setup of AWX, added structure for a first playbook
Documented the setup of an AWX instance using docker-compose.
Added a first playbook including inventory

Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-05-02 12:40:20 +02:00
Marc Mattmüller d4f00bf431 doc/nwl-ci: added parts about CI adaptions
the nightly timer triggers the job without target parameter. Thus,
the job checks if it is a nightly build and takes a default target
which is the clearfog one.

Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-05-01 12:04:54 +02:00
Marc Mattmüller dd0c8c871c doc: updated changes due to permission restriction
Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-04-25 15:15:04 +02:00
Marc Mattmüller 0e39db0e35 README,doc: added next-level-CI and NWL-CI documentation
adapted README accordingly to build the documentation.

Signed-off-by: Marc Mattmüller <marc.mattmueller@netmodule.com>
2023-04-18 16:05:34 +02:00