Koji/Installation - Historique des versions

Didier : /* Configuration */

2015-04-23T11:38:15Z

Configuration

← Version précédente		Version du 23 avril 2015 à 11:38
Ligne 559 :		Ligne 559 :

	DNUsernameComponent = CN		DNUsernameComponent = CN
	ProxyDNs = /C=FR/ST=Languedoc Roussillon/O=Home/OU=kojiweb/CN=koji.didier-linux.eu/emailAddress=root~~@didier-linux.eu\|/C=FR/ST=Languedoc Roussillon/O=Home/OU=Admin/CN=didier/emailAddress=didier~~@didier-linux.eu		ProxyDNs = C=FR,ST=Languedoc Roussillon,L=Beaucaire,O=Home,OU=kojiweb,CN=koji.didier-linux.eu,emailAddress=root@didier-linux.eu

	LoginCreatesUser = On		LoginCreatesUser = On

Didier : /* Se donner les droits admin */

2015-04-23T11:34:59Z

Se donner les droits admin

← Version précédente		Version du 23 avril 2015 à 11:34
Ligne 410 :		Ligne 410 :
	Commande permettant de se donner les droits administrateur. Pour la lancer, on doit connaitre l'ID de l'utilisateur.		Commande permettant de se donner les droits administrateur. Pour la lancer, on doit connaitre l'ID de l'utilisateur.
	<pre>		<pre>
	koji=> insert into user_perms (user_id, perm_id, creator_id) values (<id of user inserted above>, 1, <id of user inserted above>);		koji=> insert into user_perms (user_id, perm_id, creator_id) values (<ID of user inserted above>, 1, <ID of user inserted above>);
	</pre>		</pre>
	{{Admon/tip\|Connaitre l'ID des utilisateurs\|Pour connaitre les IDs des utilisateurs du <class>Koji</class>, on doit lancer une commande SQL.		{{Admon/tip\|Connaitre l'ID des utilisateurs\|Pour connaitre les IDs des utilisateurs du <class>Koji</class>, on doit lancer une commande SQL.

Didier : /* Koji Web - Interface for the Masses */

2015-04-22T10:14:01Z

Koji Web - Interface for the Masses

← Version précédente		Version du 22 avril 2015 à 10:14
Ligne 626 :		Ligne 626 :

	'''Fichiers de Configuration:'''		'''Fichiers de Configuration:'''
			* /etc/kojiweb/web.conf
	* /etc/httpd/conf.d/kojiweb.conf		* /etc/httpd/conf.d/kojiweb.conf
	* /etc/httpd/conf.d/ssl.conf		* /etc/httpd/conf.d/ssl.conf
Ligne 639 :		Ligne 640 :

	Avec l'authentification SSL, elle doit aussi fournir le nom des certificats à utiliser et la directive ''PythonOption WebCert'' doit contenir '''la clé publique ET la clé privée'''.		Avec l'authentification SSL, elle doit aussi fournir le nom des certificats à utiliser et la directive ''PythonOption WebCert'' doit contenir '''la clé publique ET la clé privée'''.
	{{Admon/file\|<path>/etc/~~httpd~~/~~conf.d/kojiweb~~.conf</path>\|		{{Admon/file\|<path>/etc/kojiweb/web.conf</path>\|
	<pre>		<pre>
	~~PythonOption KojiHubURL http://hub.example.com/kojihub~~		[web]
	~~PythonOption KojiWebURL http://www.example.com/~~koji		SiteName = koji
	~~PythonOption KojiPackagesURL http://server.example.com/mnt/koji/packages~~		KojiTheme = didier

	~~PythonOption WebCert~~ /~~etc/pki~~/koji/~~kojiweb.pem~~		KojiHubURL http://koji.didier-linux.eu/kojihub
	~~PythonOption ClientCA~~ /~~etc~~/~~pki/koji/koji_ca_cert~~.~~crt~~		KojiFilesURL http://www.didier-linux.eu/kojifiles
	~~PythonOption KojiHubCA /etc~~/~~pki/koji/koji_ca_cert.crt~~

	~~PythonOption~~ LoginTimeout 72		WebCert /etc/pki/koji/kojiweb.pem
	~~PythonOption~~ Secret CHANGE_ME		ClientCA /etc/pki/koji/koji_ca_cert.crt
			KojiHubCA /etc/pki/koji/koji_ca_cert.crt

			LoginTimeout 72
			Secret CHANGE_ME

			LibPath = /usr/share/koji-web/lib
	</pre>}}		</pre>}}

Didier : /* Configuration générale */

2015-04-21T14:17:19Z

Configuration générale

← Version précédente		Version du 21 avril 2015 à 14:17
Ligne 689 :		Ligne 689 :
	==== Configuration générale ====		==== Configuration générale ====

	/etc/kojid/kojid.conf:		Le fichier de configuration de chaque constructeur doit être édité afin que la directive ''server'' pointe sur l'hôte supportant le Koji-hub. La directive ''user'' doit contenir le nom d'hôte du constructeur.
	''The configuration file for each koji builder must be edited so that the line below points to the URL for the koji hub. The user tag must also be edited to point to the username used to add the koji builder.''		{{Admon/file\|<path>/etc/kojid/kojid.conf</path>\|
	<pre>		<pre>
	; The URL for the xmlrpc server		; The URL for the xmlrpc server
Ligne 698 :		Ligne 698 :
	; in this example follow as below		; in this example follow as below
	user = kojibuilder1.example.com		user = kojibuilder1.example.com
	</pre>		</pre>}}

	''~~This item may be changed, but may not be the same as KojiDir on the kojihub~~.conf ~~file (although it can be something under KojiDir, just not the same as KojiDir)''~~		La directive ''workdir'' peut être différente entre les constructeurs mais elle ne doit pas être le répertoire de travail du Koji (<path>/mnt/koji</path>)
			{{Admon/file\|<path>/etc/kojid/kojid.conf</path>\|
	<pre>		<pre>
	; The directory root for temporary storage		; The directory root for temporary storage
	workdir=/tmp/koji		workdir=/tmp/koji
	</pre>		</pre>}}

	==== Configuration des certificats SSL ====		==== Configuration des certificats SSL ====

Didier : /* Configuration des certificats SSL */

2015-04-21T14:06:55Z

Configuration des certificats SSL

← Version précédente		Version du 21 avril 2015 à 14:06
Ligne 708 :		Ligne 708 :
	==== Configuration des certificats SSL ====		==== Configuration des certificats SSL ====

	/etc/kojid/kojid.conf:		Ces entrées doivent être éditées pour pointer sur les bons certificats générés précédemment.
	~~''If you are using SSL, these settings need to be edited to point to the certificates you generated at the beginning of the setup process.''~~		{{Admon/file\|<path>/etc/kojid/kojid.conf</path>\|
	<pre>		<pre>
	;client certificate		;client certificate
Ligne 721 :		Ligne 721 :
	;certificate of the CA that issued the HTTP server certificate		;certificate of the CA that issued the HTTP server certificate
	serverca = /etc/kojid/koji_ca_cert.crt		serverca = /etc/kojid/koji_ca_cert.crt
	</pre>		</pre>}}
			{{Admon/important\|Copie des certificats sur l'hôte\|Les certificats SSL doivent être copiés depuis l'hôte abritant le Koji-hub sur les constructeurs dans le répertoire <path>/etc/kojid</path> pour que les constructeurs puissent s'authentifier.}}
	~~It is~~ important ~~to note that if your builders are hosted on seperate machines from koji~~ hub ~~and koji web, you will need to scp the certificates mentioned in the above configuration file from the~~ /etc/kojid/ ~~directory on koji hub to the /etc/koji/ directory on the local machine so that the builder can be authenticated~~.

	==== Ajout d'un hôte à la base de données des constructeurs ====		==== Ajout d'un hôte à la base de données des constructeurs ====

Didier : /* Add the host entry for the koji builder to the database */

2015-04-21T13:59:16Z

Add the host entry for the koji builder to the database

← Version précédente		Version du 21 avril 2015 à 13:59
Ligne 725 :		Ligne 725 :
	It is important to note that if your builders are hosted on seperate machines from koji hub and koji web, you will need to scp the certificates mentioned in the above configuration file from the /etc/kojid/ directory on koji hub to the /etc/koji/ directory on the local machine so that the builder can be authenticated.		It is important to note that if your builders are hosted on seperate machines from koji hub and koji web, you will need to scp the certificates mentioned in the above configuration file from the /etc/kojid/ directory on koji hub to the /etc/koji/ directory on the local machine so that the builder can be authenticated.

	==== ~~Add the host entry for the koji builder to the database~~ ====		==== Ajout d'un hôte à la base de données des constructeurs ====
	~~You will now need to add the koji builder to the database so that they can be utilized by kojij~~ hub. ~~Make sure you do this before you start kojid for the first time~~,
	~~or you~~'~~ll need to manually remove entries from the~~ sessions ~~and~~ users		Il faut maintenant ajouter l'hôte à la base de données des constructeurs afin qu'il puisse être utilisé par Koji-hub.
	~~table before it can be run successfully~~.		{{Admon/important\|L'ajout doit être fait avant le premier démarrage du daemon de construction\|Sinon, il faudra purger les entrées à la main dans les tables ''sessions'' et ''users
			'' avant de pouvoir démarrer avec succès le daemon.}}
	<pre>		<pre>
	~~kojiadmin@localhost$~~ koji add-host kojibuilder1.~~example~~.~~com~~ i386 x86_64		koji add-host kojibuilder1.didier-linux.eu i386 x86_64
	</pre>		</pre>
	~~The first~~ argument ~~used after the~~ '~~'add-host'' command should the username of the builder~~. ~~The~~ second argument ~~is used to specify the~~ architecture ~~which the builder uses~~.		Le premier argument après la commande est le nom d'hôte du constructeur. Le second argument spécifie l'(les) architecture(s) utilisées par l'hôtes.

	==== Ajout de l'hôte au canal de création ====		==== Ajout de l'hôte au canal de création ====

Didier : /* Ajout de l'hôte au canal de création */

2015-04-21T13:52:18Z

Ajout de l'hôte au canal de création

← Version précédente		Version du 21 avril 2015 à 13:52
Ligne 736 :		Ligne 736 :
	==== Ajout de l'hôte au canal de création ====		==== Ajout de l'hôte au canal de création ====

	Les canaux sont un moyen de contrôler quel constructeur fait quoi. Par défaut les hôtes sont ajouté au canal ''default''. Il faut qu'au moins quelques uns (1 au minimum) soient ajoutés au canal ''createrepo'' pour ~~ppouvoir~~ lancer les travaux kojira sur les dépôts.		Les canaux sont un moyen de contrôler quel constructeur fait quoi. Par défaut les hôtes sont ajouté au canal ''default''. Il faut qu'au moins quelques uns (1 au minimum) soient ajoutés au canal ''createrepo'' pour pouvoir lancer les travaux kojira sur les dépôts.
	<pre>		<pre>
	koji add-host-to-channel kojibuilder1.didier.eu createrepo		koji add-host-to-channel kojibuilder1.didier.eu createrepo

Didier : /* Add the host to the createrepo channel */

2015-04-21T13:51:51Z

Add the host to the createrepo channel

← Version précédente		Version du 21 avril 2015 à 13:51
Ligne 734 :		Ligne 734 :
	The first argument used after the ''add-host'' command should the username of the builder. The second argument is used to specify the architecture which the builder uses.		The first argument used after the ''add-host'' command should the username of the builder. The second argument is used to specify the architecture which the builder uses.

	==== ~~Add the host to the createrepo channel~~ ====		==== Ajout de l'hôte au canal de création ====
	~~Channels are a way to control which builders process which tasks. By default~~
	~~hosts are added to the ''default'' channel. At least some build hosts also needs to be added~~
	~~to the ''createrepo'' channel so there will be someone to process repo creation tasks initiated by kojira.~~

			Les canaux sont un moyen de contrôler quel constructeur fait quoi. Par défaut les hôtes sont ajouté au canal ''default''. Il faut qu'au moins quelques uns (1 au minimum) soient ajoutés au canal ''createrepo'' pour ppouvoir lancer les travaux kojira sur les dépôts.
	<pre>		<pre>
	~~kojiadmin@localhost$~~ koji add-host-to-channel kojibuilder1.~~example~~.~~com~~ createrepo		koji add-host-to-channel kojibuilder1.didier.eu createrepo
	</pre>		</pre>

Didier : /* A note on capacity */

2015-04-21T13:44:30Z

A note on capacity

← Version précédente		Version du 21 avril 2015 à 13:44
Ligne 743 :		Ligne 743 :
	</pre>		</pre>

	==== ~~A note on capacity~~ ====		==== Capacité ====
	~~The default capacity of a host added to the host database is~~ 2~~. This means that once the~~ load average ~~on that machine exceeds~~ 2~~, kojid will not accept any additional tasks~~. ~~This is separate from the maxjobs item in the~~ configuration ~~file~~. ~~Before kojid will accept a job~~, ~~it must pass both the test to ensure the~~ load average ~~is below capacity and that the current number of jobs it is already processing is less than maxjobs~~. ~~However~~, ~~in today~~'~~s modern age of quad core and higher CPUs~~, a load average of 2 ~~is generally insufficient to fully utilize hardware~~. ~~As there is not an~~ option ~~to set the capacity of the host via the command line tools~~, ~~it must be done manually in~~ psql.
			La capacité d'un hôte par défaut est de 2, ce qui veut dire que le daemond econstruction n'acceptera pas de travail supplémentaire si le load average est supérieur à 2. Ce paramètre est différent de celui du nombre maximal de travaux (fichier de configuration). Avant que ledaemon de construction n'accepte un nouveau travail, il s'assure que le load average est inférieur à la capacité et que le nombre de travaux est inférieur au nombre maximal. Toutefois, à l'ère des CPU multi-coeurs, un load average de 2 est insuffisant pour consommer 100% des ressources du système. Il n'y a pas d'option pour définir la capacité en ligne de commande, cela doit être fait en base (psql).

	<pre>		<pre>
Ligne 751 :		Ligne 752 :
	row		row
	--------------------------------		--------------------------------
	(1,kojibuilder1.~~example~~.~~com~~,2)		(1,kojibuilder1.didier-linux.eu,2)
	(2,kojibuilder2.~~example~~.~~com~~,2)		(2,kojibuilder2.didier-linux.eu,2)
	(2 rows)		(2 rows)

Didier : ans

2015-04-21T13:05:08Z

ans

← Version précédente		Version du 21 avril 2015 à 13:05
Ligne 760 :		Ligne 760 :
	</pre>		</pre>

	==== ~~Start~~ Kojid ====		==== Démarrage du daemon Kojid ====

	~~Once the builder has been added to the database you must start kojira~~		Une fois le constructeur ajouté à la base de données, on peut démarrer son daemon de construction.
	<pre>		<pre>
	~~root@localhost$ /sbin/service~~ kojid ~~start~~		systemctl start kojid
	</pre>		</pre>
	~~Check~~ /var/log/kojid.log ~~to verify that kojid has started successfully~~. ~~If the log does not show any errors then the koji builder should be up and ready~~. ~~You can check this by pointing your web browser to the~~ web ~~interface and clicking on the hosts tab~~. ~~This will show you a list of builders in the database and the~~ status ~~of each builder~~.		On vérifie dans le fichier <path>/var/log/kojid.log</path> qur le daemon a bien démarré. Si aucune erreur n'est rapportée, c'est que le daemon doit être correctement configuré et démarré. On peut le vérifier sur l'interface Koji-web dans l'onglet ''hôtes''. Cette page affiche le liste des constructeurs et leur status.

	== Kojira - Création et maintenance du dépôt ==		== Kojira - Création et maintenance du dépôt ==

Koji/Installation - Historique des versions

Didier : /* Configuration */

Didier : /* Se donner les droits admin */

Didier : /* Koji Web - Interface for the Masses */

Didier : /* Configuration générale */

Didier : /* Configuration des certificats SSL */

Didier : /* Add the host entry for the koji builder to the database */

Didier : /* Ajout de l'hôte au canal de création */

Didier : /* Add the host to the createrepo channel */

Didier : /* A note on capacity */

Didier : ans