提交 252564aa 编写于 作者: A Alexander Shopov

Bulgarian translation of HTML files

上级 b90f067e
<div>
Ако вашият Jenkins е зад защитна стена и няма пряка връзка към Интернет, а JVM на сървъра не е
настроена правилно, за да се позволи връзка с Интернет, може да укажете име на сървър-посредник
за HTTP, за да позволите на Jenkins самостоятелно да инсталира приставки. (за повече детайли:
<a href="http://download.oracle.com/javase/6/docs/technotes/guides/net/properties.html">Networking Properties</a>)
Jenkins използва HTTPS, за да се свърже със сървъра за обновяване и изтегли приставките.
<p>
Ако полето е празно, Jenkins ще се свързва директно с Интернет.
<p>
Ако не сте сигурни, вижте какви са настройките на браузъра ви.
</div>
<div>
Шаблони за имената на сървърите, към които да се свързва директно, а не през сървъра-посредник.
По един шаблон на ред. „*“ напасва всички имена (напр. „*.cloudbees.com“ или „w*.jenkins.io“)
</div>
<div>
Това поле определя порта за сървъра-посредник по HTTP.
</div>
<div>
Това поле определя името за идентификация пред сървъра-посредник .
<p>
Ако този сървър-посредник ползва схемата да идентификация на
Microsoft: <a href="http://en.wikipedia.org/wiki/NTLM">NTLM</a>,
то името за домейна се добавя пред потребителското име с
разделител „\“. Например: „ACME\John Doo“".
</div>
......@@ -7,7 +7,7 @@
<p>
Например, ако проектът трябва да се изгражда само на определени
операционни системи или на компютри, на които са инсталирани специфични
интструменти, можете да укажете на проекта да се изгражда само на машини,
инструменти, можете да укажете на проекта да се изгражда само на машини,
коитоy отговарят на интересуващите ви критерии.
<p>
Помощният текст за полето <i>Израз с етикети</i>, което се показва, когато
......
......@@ -16,7 +16,7 @@
определен момент няма достатъчно свободни машини, то заявките за изграждане ще
изчакват в опашка както обикновено.
<p>
Включването на паралелните изграждание е полезно при проекти с дълги тестове,
Включването на паралелните изграждане е полезно при проекти с дълги тестове,
защото това позволява отделното изграждане да съдържа сравнително малък на
брой промени, без това да увеличава прекомерно много времето за работа, защото
всяко ново изграждане няма нужда да изчаква завършването на всички предишни
......@@ -25,18 +25,19 @@
може да са напълно независими едно от друго — при определени стойности на
параметрите.
<p>
Всяко Each concurrently executed build occurs in its own build workspace, isolated
from any other builds. By default, Jenkins appends "<tt>@&lt;num&gt;</tt>" to
the workspace directory name, e.g. "<tt>@2</tt>".<br>
The separator "<tt>@</tt>" can be changed by setting the
<tt>hudson.slaves.WorkspaceList</tt> Java system property when starting
Jenkins. For example, "<tt>hudson.slaves.WorkspaceList=-</tt>" would change
the separator to a hyphen.<br>
For more information on setting system properties, see the <a
Всяко паралелно изпълнявано изграждане се извършва в отделно от всички други
работни пространства. Стандартно добавя „<tt>@&lt;номер&gt;</tt>“ към името на
работната директория, например „<tt>@2</tt>.<br>
Разделителят „<tt>@</tt>“ може да се смени с промяната на системното свойство
на Java — „<tt>hudson.slaves.WorkspaceList</tt>“ при стартирането на Jenkins.
Например чрез „<tt>hudson.slaves.WorkspaceList=-</tt>“ ще смените разделителя
с тирето от ASCII.<br>
За повече информация погледнете <a
href="https://jenkins.io/redirect/setting-system-properties"
target="_blank">wiki page</a>.
target="_blank">документацията в уикито</a>.
<p>
However, if you enable the <i>Use custom workspace</i> option, all builds will
be executed in the same workspace. Therefore caution is required, as multiple
builds may end up altering the same directory at the same time.
Ако настройката <i>Специално работно пространство</i> е включена, всички
изграждания на проекта ще се правят в едно и също работно пространство,
поради което трябва да внимавате, защото множество изпълнения може едновременно
да променят работната директория.
</div>
......@@ -2,7 +2,7 @@
Логически израз, който определя кои агенти могат да изграждат този проект.
Изразът ще се изчисли с всеки етикет и име на всеки наличен агент и резултатът
ще е или <i>истина</i>, или <i>лъжа</i>. Само когато изразът се изчисли като
<i>истина</i>, агенът ще може да изгражда този проект.
<i>истина</i>, агентът ще може да изгражда този проект.
<p>
Ако проектът трябва задължително да се изгражда на определен подчинен компютър
или на основния, въведете съответно името на компютъра или
......@@ -86,7 +86,7 @@
изразите.
</li>
<li>
Напасване на етикетите или имената на компютрите с шаблони или регуларни
Напасване на етикетите или имената на компютрите с шаблони или регулярни
изрази не се поддържа.
</li>
<li>
......@@ -118,7 +118,7 @@
<dt><tt>postgres &amp;&amp; !vm &amp;&amp; (linux || freebsd)</tt></dt>
<dd>
Изгражданията на този проект може да са на всеки агент под Linux или
FreeBSD, стига да <i>не</i> са във във виртуала машина, и да е инсталирана
FreeBSD, стига да <i>не</i> са във виртуална машина, и да е инсталирана
базата PostgreSQL (като приемаме, че на всяка машина са поставени
съответните етикети, напр. всяка виртуална машина е с етикет <tt>vm</tt>,
иначе примерът няма да сработи).
......
<div>
Етикетите се използват за групирането на множество машини в една логическа
група.
<p>
Например, ако имате множество компютри с Windows и задача за изграждане, която
може да се изпълни само под Windows, можете да маркирате машините с етикет
<tt>windows</tt> и да обвържете задачата с този етикет.
<br>
Така конкретното изграждане ще се изпълни само на машина с такъв етикет.
<p>
Не е задължително етикетите да отговарят на операционната система. Те могат
да съответстват на произволен атрибут като архитектурата на процесора,
наличието на определена програма на машината и др.
<p>
Множество етикети се въвеждат разделени с интервал. Например:
<tt>windows docker</tt> означава, че машината има два етикета — <tt>windows</tt>
и <tt>docker</tt>.
<p>
Етикетите могат да съдържат произволни знаци, но трябва да избягвате специални
знаци като: <tt>!&amp;|&lt;&gt;()</tt>, защото Jenkins позволява дефинирането на
изрази с етикети, в които тези знаци може да се използват.
</div>
<div>
Името трябва да е уникално в рамките на тази инсталация на Jenkins.
<p>
Няма нужда да е същото като името на хоста, но често е удобно да са
еднакви.
<p>
Името не трябва да съдържа никой от следните знаци:
<tt>?*/\%!@#$^&amp;|&lt;&gt;[]:;</tt>
<!-- See jenkins.model.Jenkins#checkGoodName -->
</div>
<div>
Максималният брой едновременни задачи, които Jenkins може да изгражда на
тази машина.
<p>
Добра първоначална стойност е броят процесори на всяка машина. Задаването
на по-висока стойност ще забави всяко от изгражданията, но може да увеличи
общия брой изграждания. Във всеки отделен момент е възможно едно изграждане
да се нуждае от процесорно време, докато друго може да изчаква за
входно/изходни операции. Така двете изграждания може да се изпълняват
едновременно.
<p>
Агентите трябва да могат да изпълняват минимум едно изграждане. Ако искате
временно да спрете всички изграждания на машината, използвайте бутона
<i>Временно извън линия</i> от страницата на агента.
<p>
Това не се отнася до управляващия компютър на Jenkins. Ако зададете броя
изграждания да е <tt>0</tt>, на него няма да се изграждат никакви задания.
</div>
<div>
Параметрите позволяват на потребителите да въведат данни, които да се
използват по време на изграждането. Например, проект за тестове за
производителност при заявка, който позволява на потребителите да
качват изпълними файлове, които да се тестват. Това може да се случи
с добавянето на <i>Параметър: файл</i>.
<br>
Друга възможност е проект, който изготвя крайния вариант на програма
и искате да позволите на потребителите до прикачат към нея бележки по
версията. Може да постигнете това като добавите <i>Параметър: многоредов
низ</i>.
<p>
Всеки параметър има <i>име</i> и <i>стойност</i>, която зависи от вида на
параметъра. Тези двойки име-стойност се изнасят като променливи на средата
при стартиране на изграждането, което позволява на последващите стъпки от
него да достъпват стойностите чрез синтаксиса <tt>${ИМЕ_НА_ПАРАМЕТЪР}</tt>
(под Windows e <tt>%ИМЕ_НА_ПАРАМЕТЪР%</tt>).
<br>
Това е и причината <i>името</i> на всеки параметър да е уникално.
<p>
При параметризирането на проект, стандартната връзка <i>Изграждане</i>
се замества с връзка <i>Изграждане с параметри</i>. Чрез нея потребителите
могат да указват стойности за всеки от дефинираните параметри. Ако не въведат
нищо, се използва отделна стандартна стойност за всеки от параметрите.
<p>
Ако изграждането е стартирано автоматично, например от промяна в системата за
контрол на версиите, за всеки от параметрите ще се ползва стандартната му
стойност.
<p>
Когато има поне едно параметризирано изграждане в опашката, опит за стартирането
на друго ще е успешно, ако поне един от параметрите е различен, освен ако не е
зададена опцията <i>Едновременно изграждане при необходимост</i>.
<p>
За повече информация вижте <a href="https://jenkins.io/redirect/parameterized-builds"
target="_blank">страницата за параметризираните изграждания</a> в уикито.
</div>
<div>
<p>
Компютърът за изграждания трябва да има директория, която да се ползва
само от Jenkins. Укажете пътя до директорията. Най-добре ползвайте
абсолютен път като <tt>/var/jenkins</tt> или <tt>c:\jenkins</tt>.
Това е локален път — както се вижда на машината за изграждания. Няма
нужда пътят да се вижда от командната машина.
<p>
Изграждащите машини не съдържат важни данни — всички настройки по задачите,
журналите от изгражданията както и артефактите се държат на компания компютър,
затова е напълно допустимо да се ползва временна директория като основна на
подчинените машини.
<br>
Има полза директорията да не е временна, защото след рестартиране на машината
тя остава и може да държи кеширани инсталациите на инструменти, или местата
за изграждания. Това минимизира повтарящите се изтегляния на инструменти
или ресурси от системите за контрол на версии при стартирането на ново
изграждане след рестартиране.
<p>
Ако използвате относителен път като <tt>./jenkins-agent</tt>, пътят се определя
спрямо работната директория указана в <i>Начина за стартиране</i>.
<ul>
<li>При стартиранията, при които Jenkins управлява пускането на агента,
като например SSH, текущата директория най-често е една и съща, примерно
домашната директория на потребителя.</li>
<li>При стартиранията, при които Jenkins не ги управлява, като JNLP през
командния ред или връзка за уеб браузъра, текущата директория може да се
променя при всяко стартиране. В този случай ползването на относителен път
може да доведе до проблеми.
<br>
Най-често това са остарели работни места, инсталации на инструменти, което
води до свършване на свободното дисково пространство.</li>
</ul>
</div>
<div>
От голяма помощ е да знаем как Jenkins се ползва. Това може да определи
посоката на разработка, което иначе е трудно, защото няма как да се проследяват
потребителите на проект с отворен код. Като изберете тази опция Jenkins
периодично ще изпраща анонимни данни за използването.
<p>
Това е пълното описание на включената информация:
<ul>
<li>версията на jenkins;
<li>операционната система и броя изпълнявани изграждания от основния и подчинените компютри;
<li>списък с инсталираните приставки и версиите им;
<li>броят задачи за всеки вид задача в инсталацията на Jenkins
</ul>
<p>
Информацията не съдържа нищо, които да ви идентифицира или да позволява да се свържем
с вас (с изключение на информацията указана поради естеството на HTTP, като IP адреси).
Тези данни ще бъдат споделени с общността в табличен вид.
</div>
<div>
Тази опция указва минималното необходимо свободно пространство на диска, за
да се осигури правилна работа на Jenkins на машината. Примерни стойности са:
„1.5GB“, „100KB“ и т.н.
Ако свободното място на машината падне под тази стойност, тя ще бъде
маркирана извън линия.
</div>
<div>
Този датчик просто извежда архитектурата на агента. Той никога не указва
агентът да е извън линия.
</div>
\ No newline at end of file
<div>
Този датчик указва разликата в часовниците между водача и следващите машини.
Въпреки че Jenkins не е чувствителен към разликите в часовниците, системите
за контрол на версиите, както и отдалечените файлови системи (като NFS и
споделянето на файлове в Windows) често имат проблеми в такива ситуации.
<p>
За да синхронизирате часовниците, ползвайте примерно NTP.
</div>
<div>
Този датчик указва свободното дисково пространство на файловата система, в
която е разположена директорията <tt>$JENKINS_HOME</tt>. Ако то падне под
определена стойност, машината ще бъде указана като извън линия.
<p>
В тази директория се извършват всички изграждания. Когато се напълни,
изгражданията са неуспешни.
</div>
<div>
Този датчик наблюдава времето за отговор на заявка по мрежата от
водещата машина към следваща. Ако мине определен праг, агентът се извежда
като извън линия.
<p>
Това е полезно, за да се откриват агенти, които не отговарят на заявки или
мрежови проблеми, като задръстване на информационния канал. Лидерът праща
празна заявка към машините и замерва времето за отговор.
</div>
\ No newline at end of file
<div>
Този датчик указва свободното дисково пространство в директорията за
временни файлове. Когато то падне под определен праг, машината се указва
като извън линия.
<p>
Инструментите на Java както и тестовете и изгражданията често създават
временни файлове в нея и може да не работят правилно, когато няма свободно
пространство.
<p>
По-специално, проверката се извършва на файловата система, която съдържа
директорията указвана от системното свойство „<tt>java.io.tmpdir</tt>“.
За да проверите къде тя се намира на определена машина, прегледайте файла
<tt>${rootURL}/computer/SLAVENAME/systemInfo</tt>“.
</div>
<div>
Всички придобиват пълни права надJenkins, включително анонимните потребители.
<p>
Този режим е удобен в доверени среди, напр. интранета на компания, и се
нуждаете от идентификация само за персонализирането на Jenkins. В такъв
случай, ако някой трябва да направи някаква промяна, няма да има нужда да се
идентифицира и влезе в Jenkins.
</div>
\ No newline at end of file
<div>
Когато това е избрано, потребителите, които не се идентифицирали, ще могат да
достъпват Jenkins в режим само за четене.
</div>
<div>
В този режим всеки потребител на Jenkins получава пълен контрол след влизане в
системата. Анонимните потребители имат достъп само за четене и не могат да
управляват Jenkins.
<p>
Този режим кара потребителите да влязат в системата, преди да могат да
извършат промяна. Така може да се следи кой какви промени прави. Режимът е
удобен и при публично достъпни инсталации на Jenkins, при които само на
определени потребители може да се има доверие и да имат регистрации.
</div>
<div>
Jenkins използва порт па TCP, за да комуникира с подчинените компютри.
Тази опция задава кои протоколи за връзка са включени.
</div>
<div>
Изберете тази опция, за да премахнете полето „Запомняне на този компютър“ от
екрана за вход.
</div>
\ No newline at end of file
<div>
Jenkins използва порт на TCP, за да се свърже с агенти, които са стартирани
през JNLP. Обикновено този порт е случаен, за да се избягва припокриване с
други системи, но това прави поддържането на сигурността по-трудна. Ако не
ползвате агенти с JNLP, по-добре е да изключите този порт на TCP. Другият
вариант и да въведете постоянен порт, което улеснява настройването на
защитната стена.
</div>
\ No newline at end of file
<div>
<p>
Включването на сигурността осигурява идентификацията (кои са) и упълномощаването (какви права имат) на потребителите.
</p>
<p>
Има доста вградени варианти. Даването на прекомерни права на анонимни потребители или даването на прекомерни права
на всеки, който може да влезе, при условие, че може свободно да се регистрира, не е начин да се увеличи сигурността.
</p>
<p>
За повече информация за сигурността и Jenkins вижте
<a href="https://jenkins.io/redirect/securing-jenkins">документацията в уикито</a>.
</div>
<div>
Поведение като версиите на Jenkins преди 1.164. Ако притежавате ролята
„admin“ ще имате пълен контрол върху системата, в противен случай,
включително, ако не сте влезли, имате права само за четене.
</div>
<div>
Някои сървъри-посредници за HTTP филтрират информацията, която стандартно се
използва за изчисляване на еднократно използваните стойности. Ако между
браузъра и Jenkins стои сървър-посредник и получавате код за грешка 403,
когато подавате формуляр, пробвайте да зададете тази настройка. Недостатъкът
е, че така еднократните стойности се фалшифицират по-лесно.
</div>
<div>
Заявките с фалшив произход (CSRF/XSRF) са начин, който позволява на трета
страна да извършва действия на сайта от ваше име, без да има право на това. В
случая на Jenkins това би позволило на неупълномощени лица да изтриват задания,
изграждания или да променят настройките на Jenkins.
<p>
Когато това е включено, Jenkins ще проверява за специална еднократна стойност
при всяка заявка, която променя нещо на сървъра. Това включва подаването на
всеки формуляр и заявките към отдалеченото API.
<p>
Включването на тази опция може да доведе и до някои проблеми, например:
<ul>
<li>някои възможности на Jenkins, като отдалеченото API стават по-трудни за
употреба</li>
<li>някои възможности в приставките, особено тези, които не са тествани
достатъчно, може съвсем да не работят;</li>
<li>ако достъпвате Jenkins през насрещен сървър-посредник, той може да
филтрира заглавните части на HTTP за CSRF, което ще направи някои
защитени действия невъзможни.</li>
</ul>
<p>
Повече информация за заявките с фалшив произход (CSRF) има
<a href="http://www.owasp.org/index.php/Cross-Site_Request_Forgery">тук</a>.
</div>
<div>
Може да зададете максималният брой агенти, които Jenkins може да стартира в
облака. Така ще избегнете неприятни изненади, когато пристигне сметката
за ползваните ресурси.
<P>
Ако въведете 3, Jenkins ще стартира нови агенти само докато общият им брой не
надхвърли това число. Дори и в най-лошия случай да забравите да ги спрете,
има граница, която няма де се надхвърли.
<p>
Ако полето е празно, няма никакви ограничения за използваните ресурси в този облак.
</div>
<div>
Команда за стартирането на агента, който управлява компютъра и комуникира
с управляващия компютър. Jenkins приема, че изпълнената програма ще
стартира <tt>slave.jar</tt> на правилната машина.
<p>
Може да изтеглите <tt>slave.jar</tt>
<a href="${rootURL}/jnlpJars/slave.jar"><tt>оттук</tt></a>.
<p>
В най-простия случай, това може да е команда като тази:
„ssh <i>hostname</i> java -jar ~/bin/slave.jar“.
Често е по-добре да напишете малък скрипт подобен на този отдолу, за да може да
настройвате местоположението на Java и/или slave.jar, както и да променяте
променливите на средата на машината, например „PATH“:
<pre>
#!/bin/sh
exec java -jar ~/bin/slave.jar
</pre>
<p>
Може да използвате произволна команда за стартирането на процеса на управляваната
машина, стига тя да е в състояние да изпълни „java -jar ~/bin/slave.jar“ като
остане свързана със стандартните вход и изход на този процес.
<p>
При по-големи инсталации може да зареждате <tt>slave.jar</tt> от споделен монтиран
ресурс, например NFS, така че да не се налага ръчно да обновявате файла при всяко
обновяване на Jenkins.
<p>
Ако имате проблеми със свързаността, може да ги изчистите по-лесно като зададете
командата да е „ssh -v <i>hostname</i>“.
</div>
<div>
При необходимост тук попълнете допълнителните аргументи за стартирането на
виртуалната машина на Java на подчинените компютри като „-Xmx256m“.
Погледнете документацията за
<a href="http://java.sun.com/javase/technologies/hotspot/vmoptions.jsp" target="_new">пълния списък</a>.
</div>
<div>
Обичайно изграждане, при което отсъстват обектите за архивиране, се
обявява за неуспешно. Ако изберете тази опция, отсъствието на
обекти за архивиране ще доведе само до предупреждение, изграждането
ще се третира като успешно.
</div>
<div>
Можете да използвате шаблонни знаци като „module/dist/**/*.zip“.
За точния формат погледнете
<a href='http://ant.apache.org/manual/Types/fileset.html'>документацията
на атрибута „includes“ за наборите от файлове на Ant</a>. Базовата
директория е <a href='ws/'>работното пространство</a>. Можете да
архивирате само файлове, които се съдържат в него.
</div>
<div>
Архивирането на артефакти използва <code>org.apache.tools.ant.DirectoryScanner</code>
на Ant. Стандартно този инструмент различава главни и малки букви — ако задачата
създава файлове с разширение „.hpi“, шаблонът „**/*.HPI“ ще ги прескочи.<BR/><BR/>
Различаването на регистъра на буквите може да се изключи с тази опция. Когато тя
не е избрана, шаблонът „**/*.HPI“ ще напасва и файлове с разширение „*.hpi“, а
шаблонът „**/cAsEsEnSiTiVe.jar“ ще напасне и с файла „caseSensitive.jar“.
</div>
<div>
Допълнително може да укажете
<a href='http://ant.apache.org/manual/Types/fileset.html'>изключващ шаблон „excludes“</a>,
като „foo/bar/**/*“. Файл, който отговаря на такъв шаблон, няма да бъде архивиран, дори
и да напасва шаблона указан във файловете за архивиране.
</div>
<div>
Архивиране на изградените артефакти (напр. разпространяваните или публикувани
файлове), така че да могат да бъдат изтеглени по-късно. Те ще са достъпни от
страницата на Jenkins.
<br />
Обичайно Jenkins пази изградените обекти докато се пазят журналните записи за
самото изграждане. Ако старите артефакти не ви трябват и предпочитате да имате
повече дисково пространство, може да укажете това.
</div>
<br/>
<div>
Забележете, че при задача с Maven, създадените артефакти се архивират автоматично.
Обектите, които настроите тук, се добавят към горните. Автоматичното архивиране
на Maven може да се изключи от допълнителните настройки на Maven.
</div>
<div>
Когато е зададена стойност, тя ще се интерпретира като изходния код, който указва нестабилно
изграждане. Ако изходният код за грешка съвпада с тази стойност, изграждането се приема за
нестабилно, но се продължава със следващите стъпки. Поддържа се най-широкия диапазон от
стойности за фамилията Windows. При Windows NT4 и следващи ERRORLEVEL е четирибайтово цяло
число със знак и интервалът е от -2147483648 до 2147483647. По-старите версии на Windows
поддържат двубайтови цели числа — от 0 до 65535. При DOS това е еднобайтова целочислена стойност
от 0 до 255. Стойност 0 се прескача и не води до обявяването на изграждането на нестабилно,
защото това е конвенцията.
</div>
<div>
Можете да използвате шаблонни знаци като <code>module/dist/**/*.zip</code>
(за точния формат погледнете секцията за
<a href="http://ant.apache.org/manual/Types/fileset.html">@includes</a> от
ръководството на Ant).
Основната директория е <a href="ws/">работното пространството</a>.
</div>
<div>
Jenkins може да записва отпечатъка на файловете (най-често това са файлове jar) за
проследяване кога и къде тези файлове са създадени и използване. Това ви помага
да получите отговори на въпроси като следните, когато имате множество проекти,
зависими един от друг:
<ul>
<li>
На диска ми има файл <tt>foo.jar</tt>, но от кое точно изграждане идва?
</li>
<li>
Ако проектът BAR зависи от файла <tt>foo.jar</tt>, който е от проекта FOO:
</li>
<li><ul>
<li>
От кое изграждане идва версията на <tt>foo.jar</tt>, която се ползва в
изграждане на №51 на BAR?
</li>
<li>
Кое изграждане на BAR ще ползва поправката на грешката, която е включена
в изграждане №32 на <tt>foo.jar</tt>?
</li>
</ul></li>
</ul>
<p>
За да се възползвате от това, трябва всички участващи проекти да използват отпечатъци
на файлове — не само проектите, от които файловете произхождат, но и тези, в които се
ползват.
<p>
За повече информация вижте
<a href="https://jenkins.io/redirect/fingerprint">документацията</a>.
</div>
<div>
Подаване на всички променливи от изграждането към процеса на maven като свойства на Java.
Рядко има нужда от това, защото променливите така или иначе са изнесени към средата.
Предпочитаният начин за достъп до тях е изрично подаване на отделните променливи от
изграждането като свойства на Java в раздела <i>Свойства</i> (<tt>MY_VAR=${MY_VAR}</tt>).
</div>
<div>
Тук се задават свойствата, които се използват от изграждането на Maven,
в стандартен формат „.properties“:
<pre># коментар
име1=стойност1
име2=стойност2
</pre>
Те се подават към Maven като „<tt>-Dиме1=стойност1 -Dиме2=стойност2</tt>
</div>
<div>
Елементът за настройки във файла <code>settings.xml</code> съдържа стойности, които
влияят на изпълнението на Maven по различни начини, подобно на файла <code>pom.xml</code>,
но не принадлежат на никой проект поотделно и не следва да се разпространяват с тях.
Това включва местоположението на локалното хранилище, допълнителни отдалечени хранилища за
код и обекти и информация за идентификация.
<br>
Стандартно файлът<code>settings.xml</code> се чете от следните места:
<ul>
<li>системната инсталация на Maven — стандартно е <code>$M2_HOME/conf/settings.xml</code></li>
<li>потребителската инсталация на Maven — стандартно е <code>${user.home}/.m2/settings.xml</code></li>
</ul>
Първото е мястото на глобалните настройки, а второто са настройките за отделен потребител. Ако и двата
файла съществуват, те се четат и сливат, като потребителските настройки са с приоритет.
<p>
За повече информация вижте <a href="http://maven.apache.org/settings.html"><code>settings.xml</code>
документацията</a>.
</div>
<div>
Обикновено това поле трябва да е празно, а Jenkins сам ще подбере правилния интерпретатор.
Ако обаче <tt>sh</tt> (под Windows) или <tt>/bin/sh</tt> е извън пътя сочен от <tt>PATH</tt>,
тук ще трябва да зададете пътя към изпълнимия файл на интерпретатора.
</div>
<div>
Когато е зададена стойност, тя ще се интерпретира като изходния код, който указва нестабилно
изграждане. Ако изходният код за грешка съвпада с тази стойност, изграждането се приема за
нестабилно, но се продължава със следващите стъпки. Поддържа се най-широкия диапазон от
стойности за фамилията Windows. При Unix това е еднобайтова целочислена стойност
от 0 до 255. Стойност 0 се прескача и не води до обявяването на изграждането на нестабилно,
защото това е конвенцията.
</div>
<div>
Изпълнение на скрипт чрез интерпретатор за изграждането на проект (стандартно е <tt>sh</tt>,
но може да се настрои). Текущата директория за изпълнението на скрипта е директорията на
работното пространство. Попълнете тук съдържанието на скрипта. Ако в началото му
липсва заглавен ред от вида: <tt>#!/bin/sh</tt>, ще се използва системният интерпретатор.
Ако в началото на скрипта има ред от вида: <tt>#!/bin/perl</tt>, ще можете да използвате
произволен интерпретатор и ще можете изрично да задавате с какви опции ще се стартира.
<p>
Стандартно интерпретаторът се извиква с опцията <tt>-ex</tt>. Така всички команди се
отпечатват преди изпълнение, а изграждането се счита за неуспешно, ако някоя от
командите завърши с код, различен от <tt>0</tt>. Може да промените това поведение,
като зададете начален ред за указване на интерпретатора като <tt>#!/bin/…</tt>.
<p>
Добра практика е да не задавате голям скрипт тук. По-добре е да го сложите в системата
за контрол на версиите, а тук просто да го извикате чрез <tt>bash -ex myscript.sh</tt>
или нещо подобно. Така ще може да следите промените в скрипта.
</div>
<div>
Команда, която да се стартира всеки път на машината за инсталиране на този
инструмент. Затова, когато инструментът е вече инсталиран, тя трябва да се
изпълнява доста бързо и да не прави нищо.
</div>
<div>
Домашната директория на програмата. (Пътят може да е относителен.)
</div>
<p>
Изпълнение на произволна последователност от команди на обвивката, които
позволяват да инсталирате програмата. Пример с Ubuntu —
предполагаме, че потребителят за Jenkins има права в <code>/etc/sudoers</code>:
</p>
<pre>sudo apt-get --yes install openjdk-6-jdk</pre>
<p>
(В този случай задайте примерно <code>/usr/lib/jvm/java-6-openjdk-i386</code> като
домашна директория.)
</p>
<p>
Друг пример с инсталиране на стара версия на Sun JDK 6 за x86 Linux,
от вече несъществуващия сайт <a href="http://jdk-distros.java.net/">DLJ</a>:
</p>
<pre>bin=jdk-6u13-dlj-linux-i586.bin
if [ \! -f $bin ]
then
wget --no-verbose http://download.java.net/dlj/binaries/$bin
sh $bin --unpack --accept-license
fi</pre>
<p>
(За домашна директория укажете <code>jdk1.6.0_13</code> в този случай.)
</p>
<div>
Избирането на тази опция позволява на Jenkins да инсталира инструмента при
нужда.
<p>
След като я изберете ще бъдете подканени да настроите серия от „инсталатори“,
които позволяват на Jenkins да инсталира инструмента.
<p>
Ако инструментът е платформено независим, като Ant, няма голяма полза. В
обратния случай това ви позволява да инсталирате платформено зависим
инструмент по различен начин — с различни скриптове, на различните среди.
</div>
<div>
Незадължителна поддиректория от изтегления и разпакетиран архив, която да се ползва
като основна директория за програмата.
</div>
<div>
Адрес, от който да се изтегли програмата в компилиран вид. Трябва да е
архив във формат zip или tar.gz. Ако вече е изтеглена предишна версия,
се сравняват времената им, за да може по-лесно да се публикуват обновления.
Адресът трябва да е достижим от командния компютър на Jenkins, няма нужда да
се вижда от подчинените машини.
</div>
-<div>
Изтегляне на архив с програма и инсталирането ѝ в работната директория на Jenkins.
Примерно: <code>http://apache.promopeddler.com/ant/binaries/apache-ant-1.7.1-bin.zip</code>
(или друг сървър-огледало, който е по-близо или бърз) и укажете поддиректория на
<code>apache-ant-1.7.1</code>.
</div>
<div>
Игнориране на известията за промяна от страна на системата за контрол на
версиите.
<p>
Това е полезно да предотвратите постоянното стартиране на продължителни
задачи, като извлечения, обработка на данни и др. при всяка отделна
промяна в системата за контрол на версиите, но все пак искате да ги стартирате
от време на време, ако промени има.
<p>
За да сработи тази опция, тя трябва да се поддържа и от приставката за системата
за контрол на версиите. В случая на Subversion, приставката трябва да е поне
версия 1.44.
</div>
<div>
Ако много проекти се изграждат след слушане за промени в системата за контрол
на версиите, може да искате да ограничите общия брой едновременни заявки към
сървъра за версиите, за да не бъде претоварен.
<p>
Попълването на положително цяло число ограничава броя на едновременните заявки
за проверка. Ако оставите полето празно, няма да има никакви ограничения в
броя на едновременните заявки.
</div>
<div>
Настройване на Jenkins за пита системата за контрол на версиите за промени.
<p>
При ползване на CVS това е ужасно скъпа операция, защото кара Jenkins да
обходи цялото работно пространство и да го синхронизира със сървъра.
По-добре е с помощта на автоматично действие от страна на CVS да известявате
Jenkins за промени. За повече информация погледнете
<a href="https://jenkins.io/redirect/scm-change-trigger">документацията</a>.
</div>
<div>
Полето следва синтаксиса на cron (с малки различия).
Всеки ред се състои от 5 полета с разделител интервал или табулация:
<pre>МИНУТА ЧАС ДЕН_ОТ_МЕСЕЦА МЕСЕЦ ДЕН_ОТ_СЕДМИЦАТА</pre>
<table>
<tr>
<td>МИНУТА</td>
<td>Минута в часа (0–59)</td>
</tr>
<tr>
<td>ЧАС</td>
<td>Час от деня (0–23)</td>
</tr>
<tr>
<td>ДЕН_ОТ_МЕСЕЦА</td>
<td>Ден от месеца (1–31)</td>
</tr>
<tr>
<td>МЕСЕЦ</td>
<td>Месец от годината (1–12)</td>
</tr>
<tr>
<td>ДЕН_ОТ_СЕДМИЦАТА</td>
<td>Ден от седмицата (0–7). И 0, и 7 са неделя.</td>
</tr>
</table>
<p>
Чрез следните оператори може да указвате множество стойности за едно поле.
Изброени от най-висок към най-нисък приоритет, това са:
</p>
<ul>
<li><code>*</code> всички възможни стойности</li>
<li><code>M-N</code> интервал от стойности</li>
<li><code>M-N/X</code> или <code>*/X</code> стъпки от интервали от X единици в указания интервал или от всички възможни стойности</li>
<li><code>A,B,...,Z</code> изброяване на множество от точни стойности</li>
</ul>
<p>
Със знака <code>H</code> включвате системата за равномерно натоварване,
използвайте го възможно най-често („H“ идва от „hash“).
Например: <code>0 0 * * *</code> за много ежедневни задачи ще доведе до голямо
натоварване в полунощ.
Противоположно на това <code>H H * * *</code> също ще изпълнява задачите ежедневно,
но няма да стартира всички по едно и също време, което води до намаляване на
необходимите ресурси.
</p><p>
Знакът <code>H</code> може да се използва с интервал.
Например <code>H H(0-7) * * *</code> означава някой момент между 00:00 AM и 7:59.
С <code>H</code> може да ползвате е постъпкови изрази с или без интервали.
</p><p>
Може да мислите за <code>H</code> като случайна стойност от съответния интервал.
Истината е, че не е случайна стойност, а е базирана на хеша от името на задачата.
Така тази стойност е стабилна за всеки проект.
</p>
<p>
Кратки интервали като <code>*/3</code> или <code>H/3</code> работят по-особено
в края на месеците поради различната дължина на месеците.
Например: <code>*/3</code> ще се стартира на 1-ви, 4-ти,… 31-ни и веднага отново на 1-ви следващия месец.
Хешовете за ден от месеца се избират от интервала 1-28. Възможно и <code>H/3</code> да породи дупка
от 3 до 6 дни в края на месеца.
(Подобен ефект има и при по-дълги интервали, но там е относително по-малко забележим.)
</p>
<p>
Празните редове, както и тези, които започват с <code>#</code> се считат за коментари.
</p><p>
Допълнително може да ползвате следните синоними: <code>@yearly</code> (ежегодно), <code>@annually</code>
(ежегодно), <code>@monthly</code> (ежемесечно), <code>@weekly</code> (ежеседмично), <code>@daily</code>
(ежедневно), <code>@midnight</code> (всяка нощ) и <code>@hourly</code> (всеки час).
Те използват системата за балансиране на натоварването.
Например, <code>@hourly</code> е същото като <code>H * * * *</code> и означава някой момент в часа.
<code>@midnight</code> означава някой момент между 00:00 AM и 2:59.
</p><p>
Примери:
</p>
<pre>
# на всеки 15 минути (примерно: и 7, и 22, и 37, и 52)
H/15 * * * *
# на всеки 10 минути в първата половина на всеки час (3 пъти, примерно: и 4, и 14, и 24)
H(0-29)/10 * * * *
# на всеки два часа, при 45-тата минута на часа, почвайки от 9:45 до 15:45 всеки почивен ден от седмицата
45 9-16/2 * * 1-5
# на всеки два часа в интервала от 9 до 17 ч, всеки работен ден от седмицата (примерно: 10:38, 12:38, 14:38, 16:38 PM)
H H(9-16)/2 * * 1-5
# веднъж на ден - на всяко 1-во и 15-то число от всеки месец без декември
H H 1,15 1-11 *
</pre>
</div>
<div>
Възможност за периодично изпълнение на този проект на база време,
подобно но програмата <a href="http://en.wikipedia.org/wiki/cron">cron</a>.
<p>
Това дава възможност да ползвате Jenkins като заместител на cron.
Това <b>рядко е правилен начин за непрекъснато изграждане на проекти</b>.
Често хората, когато започват да внедряват непрекъснато изграждане, си
мислят, че проектите просто трябва да се изграждат на определен период —
примерно всеки ден или всяка седмица, което обяснява най-честата
употреба на тази възможност. Идеята обаче е друга — при непрекъснатото
изграждане трябва да се реагира с появата на всяка промяна, за да се
получи възможно най-скоро обратна връзка. Това се постига с
<a href="https://jenkins.io/redirect/scm-change-trigger">автоматични
известия от системата за контрол на версиите към Jenkins</a>.
<p>
Преди да започнете да ползвате тази възможност (cron) се спрете и
хубаво си помислете дали искате точно това.
</div>
<div>
Дали да се включи остарелият режим за команден ред с отдалечено управление.
Това отговаря на опцията <code>-remoting</code> в клиента.
Това може и да дава възможност да ползвате определени команди или техните опции,
но се счита за несигурно. Вариантът с опцията <code>-http</code> е винаги
наличен, а режимът с опцията <code>-ssh</code> — когато е включена услугата
за SSH.
</div>
<div>
Това определя, кога, ако изобщо някога, данните да изгражданията на този проект
ще се изтриват. Това включва изхода на конзолата, архивираните артефакти, както
и всички останали метаданни за съответното изграждане.
<p>
Съхраняването на по-малък брой изграждания означава, че ще се използва по-малко
дисково пространство в <i>Build Record Root Directory</i>, която се указва в
екрана за <i>Системни настройки</i> screen.
<p>
<!-- TODO: Most/all of the following should be dynamic, showing info from the
`BuildDiscarder` implementations that are currently loaded -->
Jenkins предлага две възможности за определяне кога да се изтриват старите
изграждания:
<ol>
<li>
Възраст: изтриване на изгражданията след като стигнат определена възраст:
примерно седем дни.
<li>
Брой: изтриване на всички изграждания без последните няколко.
</ol>
Тези две възможности може да се зададат едновременно — например да се държат
изгражданията от последните 14 дни, но не повече от общо 50. Ако някое от
двете ограничения се надхвърли, се изтриват всички изграждания над тях.
<p>
Можете да запазвате определени важни изграждания завинаги, независимо от
ограниченията дадени тук — натиснете бутона <i>Запазване на изграденото
завинаги</i> на страницата за изграждания.
<br>
Последното стабилно и последното успешно изграждане също се запазват, независимо
от тези ограничения.
<hr>
В раздела <i>Допълнителни</i> могат да се указват същите тези ограничения, но
специално за <b>артефактите</b> от изгражданията. Ако те бъдат включени,
артефактите, надхвърлящи ограниченията, ще бъдат изтривани. Самите изграждания
и данните се пазят, само артефактите се трият.
<p>
Например, ако проект изгражда голям инсталатор за определена програма, който
бива архивиран, а искате да запазите изхода на конзолата както и информацията
за подаването от системата за контрол на версиите, на което се базира самото
изграждане, като едновременно с това триете старите артефакти, за да не използвате
прекалено много дисково пространство.
<br>
Това е особено подходящо за проекти, в които лесно можете наново да изградите
артефактите наново.
<hr>
Забележка: Jenkins не оценя и не прилага тези правила мигновено, нито при
промяната на тези настройки, нито при надхвърлянето на ограниченията. Това
става при завършването на изграждане на проекта.
</div>
<p>
Настройване браузърът, а не Jenkins, да изтегля метаданните (списъци с наличните
приставки, инструменти и т.н.). Самото изтегляне на приставките и инструментите
ще се извърши от Jenkins, но така ще получите достъп поне да <em>разгледате</em>
обновените метаданни, когато Jenkins няма достъп до Internet, но вашия браузър
има (примерно защото ползва определен сървър-посредник, който е недостъпен за
Jenkins).
</p>
<p>
Използването на този режим не се препоръчва. Той не е надежден и е ограничен
единствено до администраторите, защото само те могат да се възползват от него.
</p>
<div>
Когато това е избрано, изгражданията, които са стартирани автоматично, ще
се добавят в опашката за изпълнение, но Jenkins ще изчаква определено време,
преди действително да стартира изграждането.
<p>
Например, ако изгражданията отнемат много време, може да искате да
предотвратите стартирането на няколко изграждания от множество подавания в
системата за контрол на версиите, който са направени по едно и също време.
Задаването на период за изчакване ще предотврати стартирането на изграждане,
когато усети първото подаване. Това дава възможност да се съберат повече
подавания за включване в изграждането. Това намалява дължината на опашката
за изграждане, намалява натоварването върху Jenkins и като резултат
разработчиците получават по бързо обратна връзка за серията от подавания.
<p>
Ако се получи заявка за ново изграждане, докато има изчакващо в опашката,
периодът му за чакане няма да се промени, а заявката няма да доведе до
ново изграждане, освен, ако изграждането е параметризирано и стойностите
на параметрите са различни от тези на изграждането в опашката.
<p>
Ако това не е избрано, се използва стандартната стойност, която е зададена
в <i>Настройки на системата</i>.
</div>
......@@ -7,8 +7,8 @@
съвместимост с предишни версии).
<p>
Това е доста уобно и хората го ползват, за да зареждат &lt;iframe>,
&lt;script> и т.н., това позволяна на недробонамерените потребители да
Това е доста удобно и хората го ползват, за да зареждат &lt;iframe>,
&lt;script> и т.н., това позволява на недобронамерените потребители да
извършат атаки чрез
<a href="http://en.wikipedia.org/wiki/Cross-site_scripting">XSS</a>.
Ако рискът е прекомерно голям, инсталирайте допълнителна приставка за
......
<div>
Указва мястото във файловата система, където Jenkins ще запазва
записите за изгражданията. Това включва изхода от конзолата, както и дугите
записите за изгражданията. Това включва изхода от конзолата, както и другите
метаданни, които се генерират при изграждане.
<p>
Стойността може да включва следните променливи:
......@@ -8,7 +8,7 @@
<li><tt>${JENKINS_HOME}</tt> — абсолютният път до домашната директория
на Jenkins;
<li><tt>${ITEM_ROOTDIR}</tt> — абсолютният път до директорията, в която
Jenkins запазвъ настройките и свързаните метаданни за определено
Jenkins запазва настройките и свързаните метаданни за определено
задание;
<li><tt>${ITEM_FULL_NAME}</tt> — пълното име на заданието, което може да
съдържа наклонени черти, напр. <tt>foo/bar</tt> за заданието
......
......@@ -8,7 +8,7 @@
<li><tt>${JENKINS_HOME}</tt> — абсолютният път до домашната директория
на Jenkins;
<li><tt>${ITEM_ROOTDIR}</tt> — абсолютният път до директорията, в която
Jenkins запазвъ настройките и свързаните метаданни за определено
Jenkins запазва настройките и свързаните метаданни за определено
задание;
<li><tt>${ITEM_FULL_NAME}</tt> — пълното име на заданието, което може да
съдържа наклонени черти, напр. <tt>foo/bar</tt> за заданието
......
<div>
Известията по е-поща от Jenkins към собствениците на проекти ще се
изпращат с този адрес на подател. Може да е само адрес като:
„jenkins@acme.org“ или „Сървър Jenkins &lt;jenkins@acme.org>“.
</div>
<div>
Възможност да зададете адреса по HTTP на инсталацията на Jenkins като:
<tt>http://yourhost.yourdomain/jenkins/</tt>. Стойността се ползва,
за да може Jenkins да сочи себе си, примерно при показването на
изображения или при генерирането на връзки в електронните писма.
<p>
Това се налага, защото няма надежден начин Jenkins сам да открие този
адрес.
</div>
<p>
Потребителско описание на шаблона за имена на задачите за изграждане.
Извежда се като съобщение за грешка при опит да се наруши конвенцията.
</p>
<div>
Използване на стандартните настройки на maven, зададени на компютъра
(<tt>$HOME/.m2/settings.xml</tt>).
</div>
\ No newline at end of file
<div>
Използване на стандартните настройки на maven, зададени на компютъра
(<tt>$HOME/.m2/settings.xml</tt>).
</div>
\ No newline at end of file
# The MIT License
#
# Bulgarian translation: Copyright (c) 2016, Alexander Shopov <ash@kambanaria.org>
#
# Permission is hereby granted, free of charge, to any person obtaining a copy
# of this software and associated documentation files (the "Software"), to deal
# in the Software without restriction, including without limitation the rights
# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
# copies of the Software, and to permit persons to whom the Software is
# furnished to do so, subject to the following conditions:
#
# The above copyright notice and this permission notice shall be included in
# all copies or substantial portions of the Software.
#
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
# THE SOFTWARE.
File\ path=\
\u041f\u044a\u0442 \u043a\u044a\u043c \u0444\u0430\u0439\u043b\u0430
<div>
Път към файла „settings.xml“ — или абсолютен, или относителен спрямо
работното пространство на проекта (поддържат се променливи).
</div>
\ No newline at end of file
<div>
Използване на специфичен глобален файл <tt>settings.xml</tt> от работното
пространство на проекта. Той трябва да бъде изтеглен от системата за контрол
на версиите като част от изграждането или да се намира на достъпно място.
</div>
\ No newline at end of file
# The MIT License
#
# Bulgarian translation: Copyright (c) 2016, Alexander Shopov <ash@kambanaria.org>
#
# Permission is hereby granted, free of charge, to any person obtaining a copy
# of this software and associated documentation files (the "Software"), to deal
# in the Software without restriction, including without limitation the rights
# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
# copies of the Software, and to permit persons to whom the Software is
# furnished to do so, subject to the following conditions:
#
# The above copyright notice and this permission notice shall be included in
# all copies or substantial portions of the Software.
#
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
# THE SOFTWARE.
File\ path=\
\u041f\u044a\u0442 \u043a\u044a\u043c \u0444\u0430\u0439\u043b\u0430
<div>
Път към файла „settings.xml“ — или абсолютен, или относителен спрямо
работното пространство на проекта (поддържат се променливи).
</div>
\ No newline at end of file
<div>
Използване на специфичен файл <tt>settings.xml</tt>. Той трябва да бъде
изтеглен от системата за контрол на версиите като част от изграждането или
да се намира на достъпно място.
</div>
\ No newline at end of file
<div>
Този жетон за API дава възможност за идентификация в извикването по REST. За повече подробности погледнете
<a href="https://jenkins.io/redirect/api-token">документацията в уикито</a>.
Жетонът от това API трябва да се пази подобно на парола, защото позволява на други хора да достъпват
Jenkins от ваше име и с вашите права.
</div>
<p>
Този списък съдържа всички предупреждиния, които се отнасят до текущо инсталираните компоненти, които
са публикувани от текущо настроените сайтове за обновления. Стандартно новините са свързани с проблими
със сигурноста. Не се показват публикуваните предупреждения, които не се за текущо инсталираните
компоненти и версии.
</p>
<p>
Стандартно отделине предупреждения са <em>избрани/активни</em>, т.е. те се показват на администраторите.
Като махнете отметката ги криете.
Това е полезно, ако сте разгледали определено предупреждение и сте сигурни, че не се отнася за вашата инсталация и
настройки, т.е. да продължите да ползвате съответната версия на определен компонент не е пробив в сигурността.
<p>
Предупрежденията могат да се изключват едно по едно, не може да заглушите всички предупреждения за определен компонент.
Ако искате въобще да изключите показването на всички предупреждения, може да направите това от <em>Настройките на системата</em>.
</p>
<div>
За повече информация вижте <a href="https://jenkins.io/redirect/security-144/">сайта на Jenkins</a>.
Силно препоръчваме да включите тази настройка.
</div>
<div>
Позволява изключването на <a href="https://github.com/jenkinsci/remoting/blob/master/docs/workDir.md">отдалечената работна
директория</a> за агента. В тези случаи подчиненият компютър ще работи в остарелия режим без журнални файлове.
</div>
<div>
Когато тук е зададена директория, Jenkins няма да стартира на този подчинен компютър, ако тя липсва.
Така може да засичате проблеми с инфраструктурата като неуспешно монтиране.
</div>
<div>
Указване на директория за съхранение на вътрешните данни.
Тя се създава като поддиректория на работната директория на подчинения компютър.
</div>
<div>
Ако е зададена, ще се ползва тази работна директория, а не тази на подчинения компютър.
Тази опция не поддържа променливи, препоръчва се да използвате само абсолютни пътища.
</div>
<div>
<p>
Задаване на автоматично насрочване на изграждане на този проект след
завършването на изграждането на друг. Така е удобно да насрочите
продължителна последователност от тестове след изграждане, когато то
е завършило, без да го забавяте.
</p><p>
Тази настройка допълва раздела „Изграждане на други проекти“ в „Действия
след изграждане“ на проект, от който този зависи, но тази е за предпочитане,
ако искате настройката да е при зависещите проекти.
</p>
</div>
<div>
Укажете имената на журналите заедно с нивата им, които това обединение
ще обхваща. Например, ако укажете <tt>hudson.model.Hudson</tt>
и <tt>info</tt>, всички журнални записи за <tt>hudson.model.Hudson</tt>
или наследниците му с ниво поне „info“ ще се записват в тази група, освен
ако по-специфично указване или по-висока подробност напасва с тях.
<p>
Ако имате множество журнални групи, всеки запис отива в най-специфичното
обединение, на което отговаря.
<p>
За повече информация за журналите в Java и Jenkins погледнете
<a href="https://jenkins.io/redirect/logging">документацията</a>.
</div>
<div>
Укажете име, което да идентифицира тази обединена група журнали.
Когато обединявате журнали, те се записват в един файл, което
улеснява прегледа. Можете де създавате множество такива групирания.
</div>
<div>
Указва стандартната стойност на полето.
</div>
<div>
Указва булев параметър, който да се използва по време на изграждането
като променлива на средата или за заместване в някоя настройка.
Стойността като низ ще е или „true“ (истина), или „false“ (лъжа).
</div>
<div>
Възможните стойности, по една на ред. По подразбиране ще се ползва
стойността на първия ред.
</div>
<div>
Указва параметър-низ, чиято стойност се избира от списък от стойности.
Тя може да се използва по време на изграждането като променлива на средата
или за заместване в някоя настройка.
</div>
<div>
Описание, което ще се покаже по-късно на потребителя.
</div>
<div>
Указва относителното спрямо работното пространство местоположение,
където качваният файл ще се запише (напр. „<tt>jaxb-ri/data.zip</tt>“).
</div>
<div>
Приема файл, качен през браузъра, като параметър за изграждането. Каченият
файл ще бъде поместен на указаното място в работното пространство, откъдето
задачата за изграждане ще има достъп до него.
<p>Това е полезно в много случаи, например:<ol>
<li>Даване на възможност на потребителите да тестват обект изграден от тях.</li>
<li>Автоматизиране на процеса на качване/тестване/публикуване на файл като
потребителите имат място, където да го поместят.</li>
<li>Изпълнение на обработка на данни след качването на набор от данни.</li>
</ol>
<p>
Името на подадения файл е налично в променливата на средата със същото
име както местоположението на файла. Ако зададете местоположението като
<tt>abc.zip</tt>, то <tt>${abc.zip}</tt> дава първоначалното име на файла
подадено от браузъра (напр. <tt>my.zip</tt>). Името не включва директорите.
</p>
<p>
Качването на файл не е задължително. Ако потребителят не избере файл,
Jenkins ще прескочи този параметър (няма да постави нов файл, но няма и
да изтрие вече съществуващ файл).
</p>
<p>
Опцията <code>-p</code> към командата <code>build</code> в режим на команден
ред приема или име на локален файл (при използването и на <code>-remoting</code>),
или празна стойност и се чете от стандартния вход (в този случай се приема само
един параметър-файл).
</p>
</div>
<div>
Име на параметъра.
<p>
Параметрите са достъпни като променливи на средата.
</div>
<div>
Филтриране на списъка с изграждания, които са включени в падащия списък.
<pre>
„Всички“ — извеждане на всички изграждания (и завършили, и изпълнявани).
„Завършени“ — извеждане на завършилите изграждания (и успешни, и неуспешни)
„Успешни“ — извеждане на успешните изграждания (и стабилни, и нестабилни).
„Стабилни“ — извеждане само на стабилните изграждания.
</pre>
</div>
<div>
Задава името на задачата, от чиито изпълнения потребителят може да избере.
Стандартно се ползва последното изпълнение. Следните параметри са
налични като променливи на средата:
<pre>
PARAMETER_NAME=<i>&lt;адрес_на_jenkins&gt;</i>/job/<i>&lt;име_на_задачата&gt;/&lt;поредно_изпълнение&gt;</i>/
PARAMETER_NAME_JOBNAME=<i>&lt;име_на_задачата&gt;</i>
PARAMETER_NAME_NUMBER=<i>&lt;поредно_изпълнение&gt;</i>
PARAMETER_NAME_NAME=<i>&lt;име_за_показване&gt;</i>
PARAMETER_NAME_RESULT=<i>&lt;резултат_от_изпълнението&gt;</i>
</pre>
</div>
<div>
Указва параметър за изпълнение, който потребителите могат да зададат
за определено изпълнение на проект. Абсолютният адрес на това конкретно
изграждане ще е достъпен като променлива на средата или като стойност
за замяна в настройките. Самото изграждане може да използва променливата,
за да запита Jenkins за допълнителна информация.
</div>
<div>
Указва стандартната стойност на, което може да спести
въвеждане на стойност всеки път.
</div>
<div>
Указва параметър-низ, в който потребителите могат да въведат
стойност, която да се използва по време на изграждането като
променлива на средата или за заместване в някоя настройка.
</div>
<div>
Изпълнение на скриптов файл на Windows за изграждане на проекта.
Скриптът ще бъде изпълнен в работната директория — тя ще е текуща да него.
Текстът, който въведете, ще се изпълни като пакетен файл. Изграждането ще се
счете за неуспешно, ако стойността на променливата на средата „%ERRORLEVEL%“
не е 0.
<p>
Ако изграждащият пакетен файл вече е в системата за контрол на версиите,
може просто да въведете относителния път към него спрямо работното
пространство и така той ще бъде изпълнен.
</div>
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册