hgbook
changeset 466:e0da346e4681
translated up to the "integration with bugzilla" section
author | Javier Rojas <jerojasro@devnull.li> |
---|---|
date | Wed Dec 24 12:40:20 2008 -0500 (2008-12-24) |
parents | aa6036a9688e |
children | 616656741ba7 |
files | es/Leame.1st es/hook.tex |
line diff
1.1 --- a/es/Leame.1st Wed Dec 24 08:06:54 2008 -0500 1.2 +++ b/es/Leame.1st Wed Dec 24 12:40:20 2008 -0500 1.3 @@ -105,7 +105,7 @@ 1.4 || intro.tex || Igor Támara || 100% || 08/11/2008 || 09/11/2008 || 1.5 || collab.tex || Igor Támara || 100% || 10/11/2008 || 06/12/2008 || 1.6 || filenames.tex || Javier Rojas || 72% || 27/11/2008 || || 1.7 -|| hook.tex || Javier Rojas || 48% || 01/12/2008 || || 1.8 +|| hook.tex || Javier Rojas || 53% || 01/12/2008 || || 1.9 || mq.tex || Igor Támara || 100% || 06/12/2008 || 13/12/2008 || 1.10 || hgext.tex || Igor Támara || 100% || 13/12/2008 || 16/12/2008 || 1.11 || template.tex || Igor Támara || || || ||
2.1 --- a/es/hook.tex Wed Dec 24 08:06:54 2008 -0500 2.2 +++ b/es/hook.tex Wed Dec 24 12:40:20 2008 -0500 2.3 @@ -728,67 +728,73 @@ 2.4 actualizar el estado del fallo 31337 a ``requiere pruebas''. 2.5 \end{itemize} 2.6 2.7 -\subsubsection{Configuring the \hook{bugzilla} hook} 2.8 +\subsubsection{Configuración del gancho \hook{bugzilla}} 2.9 \label{sec:hook:bugzilla:config} 2.10 2.11 -You should configure this hook in your server's \hgrc\ as an 2.12 -\hook{incoming} hook, for example as follows: 2.13 +Usted debería configurar este gancho en el \hgrc\ de su servidor como 2.14 +un gancho \hook{incoming}\footnote{Entrante.}, por ejemplo como sigue: 2.15 \begin{codesample2} 2.16 [hooks] 2.17 incoming.bugzilla = python:hgext.bugzilla.hook 2.18 \end{codesample2} 2.19 2.20 -Because of the specialised nature of this hook, and because Bugzilla 2.21 -was not written with this kind of integration in mind, configuring 2.22 -this hook is a somewhat involved process. 2.23 - 2.24 -Before you begin, you must install the MySQL bindings for Python on 2.25 -the host(s) where you'll be running the hook. If this is not 2.26 -available as a binary package for your system, you can download it 2.27 -from~\cite{web:mysql-python}. 2.28 - 2.29 -Configuration information for this hook lives in the 2.30 -\rcsection{bugzilla} section of your \hgrc. 2.31 -\begin{itemize} 2.32 -\item[\rcitem{bugzilla}{version}] The version of Bugzilla installed on 2.33 - the server. The database schema that Bugzilla uses changes 2.34 - occasionally, so this hook has to know exactly which schema to use. 2.35 - At the moment, the only version supported is \texttt{2.16}. 2.36 -\item[\rcitem{bugzilla}{host}] The hostname of the MySQL server that 2.37 - stores your Bugzilla data. The database must be configured to allow 2.38 - connections from whatever host you are running the \hook{bugzilla} 2.39 - hook on. 2.40 -\item[\rcitem{bugzilla}{user}] The username with which to connect to 2.41 - the MySQL server. The database must be configured to allow this 2.42 - user to connect from whatever host you are running the 2.43 - \hook{bugzilla} hook on. This user must be able to access and 2.44 - modify Bugzilla tables. The default value of this item is 2.45 - \texttt{bugs}, which is the standard name of the Bugzilla user in a 2.46 - MySQL database. 2.47 -\item[\rcitem{bugzilla}{password}] The MySQL password for the user you 2.48 - configured above. This is stored as plain text, so you should make 2.49 - sure that unauthorised users cannot read the \hgrc\ file where you 2.50 - store this information. 2.51 -\item[\rcitem{bugzilla}{db}] The name of the Bugzilla database on the 2.52 - MySQL server. The default value of this item is \texttt{bugs}, 2.53 - which is the standard name of the MySQL database where Bugzilla 2.54 - stores its data. 2.55 -\item[\rcitem{bugzilla}{notify}] If you want Bugzilla to send out a 2.56 - notification email to subscribers after this hook has added a 2.57 - comment to a bug, you will need this hook to run a command whenever 2.58 - it updates the database. The command to run depends on where you 2.59 - have installed Bugzilla, but it will typically look something like 2.60 - this, if you have Bugzilla installed in 2.61 - \dirname{/var/www/html/bugzilla}: 2.62 +Debido a la naturaleza especializada de este gancho, y porque Bugzilla 2.63 +no fue escrito con este tipo de integración en mente, configurar este 2.64 +% TODO involved => complejo ? no intarwebs here :( 2.65 +gancho es un proceso algo complejo. 2.66 + 2.67 +Antes de empezar, usted debe instalar la interfaz de Python para MySQL 2.68 +en los sistemas en los que se vaya a ejecutar el gancho. Si no está 2.69 +disponible como paquete binario para su sistema, usted puede descargar 2.70 +el paquete desde~\cite{web:mysql-python}. 2.71 + 2.72 +La información para configurar este gancho se ubica en la sección 2.73 +\rcsection{bugzilla} de su \hgrc. 2.74 +\begin{itemize} 2.75 +\item[\rcitem{bugzilla}{version}] La versión de Bugzilla instalada en 2.76 + el servidor. El esquema de base de datos que Bugzilla usa cambia 2.77 + ocasionalmente, así que este gancho debe saber exactamente qué 2.78 + esquema usar. A la fecha, la única versión soportada es la 2.79 + \texttt{2.16}. 2.80 +\item[\rcitem{bugzilla}{host}] El nombre de máquina (\emph{hostname}) 2.81 + del servidor MySQL que almacena sus datos Bugzilla. La base de datos 2.82 + debe ser configurada para permitir conexiones desde las máquinas en 2.83 + las que usted ejecute el gancho \hook{bugzilla}. 2.84 +\item[\rcitem{bugzilla}{user}] El nombre de usuario que se usará para 2.85 + conectarse al servidor MySQL. La base de datos debe ser configurada 2.86 + para permitir a dicho usuario conectarse desde cualquiera de las 2.87 + máquinas en las que se ejecute el gancho \hook{bugzilla}. Este 2.88 + usuario debe tener acceso y poder modificar las tablas de Bugzilla. 2.89 + El valor por defecto para este ítem es \texttt{bugs}, que es el 2.90 + nombre estándar del usuario para Bugzilla en una base de datos 2.91 + MySQL. 2.92 +\item[\rcitem{bugzilla}{password}] La contraseña MySQL para el usuario 2.93 + configurado anteriormente. Ésta es almacenada como texto plano, así 2.94 + que usted deberá asegurarse de que los usuarios no autorizados no 2.95 + puedan leer el fichero \hgrc\ en donde usted guarda esta 2.96 + información. 2.97 +\item[\rcitem{bugzilla}{db}] El nombre de la base de datos Bugzilla en 2.98 + el servidor MySQL. El nombre por defecto para este ítem es 2.99 + \texttt{bugs}, que es el nombre estándar de la base de datos MySQL 2.100 + en donde Bugzilla almacena sus datos. 2.101 +\item[\rcitem{bugzilla}{notify}] Si usted desea que Bugzilla envíe un 2.102 + %TODO suBscriptores? 2.103 + correo de notificación a los suscriptores después de que el gancho 2.104 + haya añadido un comentario a un fallo, necesitará que este gancho 2.105 + ejecute un comando siempre que actualice la base de datos. El 2.106 + comando que se ejecute depende de en dónde haya sido instalado 2.107 + Bugzilla, pero típicamente se verá así, si usted ha instalado 2.108 + Bugzilla en \dirname{/var/www/html/bugzilla}: 2.109 \begin{codesample4} 2.110 cd /var/www/html/bugzilla && ./processmail %s nobody@nowhere.com 2.111 \end{codesample4} 2.112 - The Bugzilla \texttt{processmail} program expects to be given a 2.113 - bug~ID (the hook replaces ``\texttt{\%s}'' with the bug~ID) and an 2.114 - email address. It also expects to be able to write to some files in 2.115 - the directory that it runs in. If Bugzilla and this hook are not 2.116 - installed on the same machine, you will need to find a way to run 2.117 - \texttt{processmail} on the server where Bugzilla is installed. 2.118 + El programa \texttt{processmail} de Bugzilla espera recibir un ID de 2.119 + fallo (el gancho reemplaza ``\texttt{\%s}'' por el ID del fallo) y 2.120 + una dirección de correo. También espera poder escribir a ciertos 2.121 + ficheros en el directorio en que se ejecuta. Si Bugzilla y éste 2.122 + gancho no están instalados en la misma máquina, usted deberá 2.123 + encontrar una manera de ejecutar \texttt{processmail} en el servidor 2.124 + donde está instalado Bugzilla. 2.125 \end{itemize} 2.126 2.127 \subsubsection{Mapping committer names to Bugzilla user names}