Configuración de GitHub

GitHub es un servicio de alojamiento basado en web para repositorios Git. Puede tener copias locales y remotas de sus repositorios, lo que facilita la colaboración.

GitHub Enterprise es un servicio de alojamiento basado en web para repositorios Git.

GitHub Issues es una herramienta de seguimiento que mantiene todo su trabajo y sus planificaciones en un mismo lugar. Está integrado con el repositorio de desarrollo de modo que pueda centrarse en las tareas importantes.

Puede configurar GitHub como una integración de herramientas de la cadena de herramientas para que pueda gestionar el código fuente en un repositorio nuevo o existente en GitHub.com o en la instancia de GitHub Enterprise de su empresa. Entre en la codificación social a través de wikis, seguimiento de problemas y solicitudes de extracción.

Si configura la integración de esta herramienta mientras crea la cadena de herramientas, siga estos pasos:

Si está almacenando el código fuente en un repositorio GitHub, en la sección Integraciones configurables, pulse GitHub. Si está configurando la integración de esta herramienta en IBM Cloud Public, debe autorizar a IBM Cloud para acceder a GitHub eligiendo OAuth o Señal de acceso personal.
- Si elige OAuth, pulse Autorizar para ir al sitio web de GitHub. Si no tiene ninguna sesión de GitHub activa, se le solicitará que inicie sesión. Pulse Autorizar aplicación para permitir que IBM Cloud acceda a su cuenta de GitHub. Si tiene una sesión de GitHub activa pero no ha especificado la contraseña recientemente, es posible que se le solicite que especifique su contraseña de GitHub para confirmar.
- Si elige Señal de acceso personal, debe especificar la señal de acceso personal que se utilizará para autorizar con GitHub la clonación de repositorios y realizar otras acciones en su nombre. Si no tiene una señal de acceso personal, puede seguir la documentación del sitio web de GitHub para crear una. Asegúrese de que la señal de acceso personal tenga los derechos repo, delete_repo, read:user y workflow.
Si utiliza un repositorio en su propio servidor GitHub Enterprise, en la sección Integraciones configurables, haga clic en Servidor personalizado.

a. Escriba un título para el servidor GitHub personalizado, especifique el URL raíz para el servidor y especifique la señal de acceso personal.

b. Si no tiene una señal de acceso personal, puede seguir la documentación del sitio web de GitHub para crear una.

c. Si su servidor GitHub está bloqueado o no es accesible desde Internet, puede conectar e integrar un Delivery Pipeline Private Worker para ejecutarlo en su propia infraestructura Kubernetes y acceder a recursos internos o locales. Para obtener más información sobre Delivery Pipeline Trabajadores privados, consulte Trabajar con Delivery Pipeline Trabajadores privados.
Revise las ubicaciones de repositorio de destino predeterminadas para los repositorios GitHub. Dichos repositorios se clonan a partir del repositorio de ejemplo. Si es necesario, cambie el nombre de los repositorios de destino.

Si tiene una cadena de herramientas y le está añadiendo esta integración de herramientas, siga estos pasos:

En la consola IBM Cloud, haga clic en el icono de menú > Automatización de la plataforma > Cadenas de herramientas. En la página Cadenas de herramientas, pulse la cadena de herramientas para abrir su página Visión general. Como alternativa, en la página Visión general de su app, en la tarjeta de Entrega continua, pulse Ver cadena de herramientas. A continuación, pulse Visión general.
Pulse Añadir herramienta.
En la sección Integraciones de herramientas, pulse GitHub.
Pulse el servidor GitHub que desea utilizar.
Si tiene un repositorio GitHub o GitHub Enterprise y desea utilizarlo, para el tipo de repositorio, pulse Existente y escriba el URL.
Si desea utilizar un nuevo repositorio GitHub o GitHub Enterprise, escriba un nombre para el repositorio, escriba el URL para el repositorio que está clonando o bifurcando, y seleccione el tipo de repositorio:

a. Para crear un repositorio vacío, pulse Nuevo.

b. Para crear una copia de un repositorio GitHub o GitHub Enterprise, pulse Clonar.

c. Para bifurcar un repositorio GitHub o GitHub Enterprise de modo que pueda aportar cambios a través de solicitudes de extracción, pulse Bifurcar.
Si es un usuario de GitHub.com con una cuenta actualizada, o si ha seleccionado un servidor de GitHub Enterprise y desea crear un nuevo repositorio privado en el servidor, marque el recuadro de selección Convertir este repositorio en privado.
Si desea utilizar GitHub Issues para realizar un seguimiento de los problemas, marque el recuadro de selección Habilitar GitHub Issues.
Si desea realizar un seguimiento del despliegue de cambios en el código mediante la creación de etiquetas y comentarios en las confirmaciones, y etiquetas y comentarios en los problemas a los que hacen referencia las confirmaciones, marque el recuadro de selección Hacer un seguimiento del despliegue cambios de código. Para obtener más información, consulte Seguimiento de la implantación del código con cadenas de herramientas.
Pulse Crear integración.
En la página Visión general de la cadena de herramientas, en la tarjeta Repositorios, pulse el repositorio de GitHub o GitHub Enterprise con el que desee trabajar. En función del repositorio seleccionado, se abrirá el sitio web de GitHub o el repositorio de GitHub Enterprise de su empresa, donde puede ver el contenido del repositorio.
Si ha habilitado GitHub Issues, pulse GitHub Issues para abrirlo. Puede utilizar esta instancia de GitHub Issues para toda la cadena de herramientas, aunque la cadena de herramientas contenga varios repositorios GitHub o GitHub Enterprise.

Si no tiene privilegios de administrador sobre el repositorio con el que va a enlazar, la integración se verá limitada porque no podrá utilizar un webhook. Los webhooks se necesitan para ejecutar automáticamente un conducto cuando se envía una confirmación al repositorio. Sin un webhook, debe iniciar los conductos manualmente.

Configuración de GitHub mediante la API

La integración de herramientas de GitHub da soporte a los siguientes parámetros de configuración que puede utilizar con la API HTTP de cadena de herramientas y SDK al crear, leery actualizar integraciones de herramientas.

Debe especificar la propiedad tool_type_id en el cuerpo de la solicitud con el valor githubconsolidated.

Parámetros de integración de la herramientaGitHub
Parámetro	Uso	Tipo	Argumento de Terraform	Descripción
url_raíz_api	opcional, actualizable	Serie	url_raíz_api	El URL de la raíz de API para el servidor GitHub.
señal_api	opcional, actualizable	Contraseña	señal_api	La señal de acceso personal (PAT). Este parámetro sólo es necesario si `auth_type` se establece en `pat`, de lo contrario se ignora.
auth_type	opcional, actualizable	Serie	auth_type	Establezca el método de autenticación que se utilizará para acceder al proveedor Git.
inicio_automático	opcional, inmutable, " `Default: false`	Boolean	inicio_automático	Establezca este valor en `true` para inicializar este repositorio con un archivo léame. Este parámetro sólo se utiliza al crear un repositorio.
conexión_ciega	opcional, actualizable, " `Default: false`	Boolean	conexión_ciega	Si se establece este valor en true significa que el servidor no es direccionable en la Internet pública. IBM Cloud no puede validar los detalles de conexión que proporcione. Determinadas funciones que requieren acceso de API al servidor git se inhabilitarán. El conducto de entrega sólo funcionará utilizando un trabajador privado que tenga acceso de red al servidor git.
rama_predeterminada	opcional, actualizable	Serie	rama_predeterminada	La rama predeterminada del repositorio Git.
enable_traceability	opcional, actualizable, " `Default: false`	Boolean	enable_traceability	Establezca este valor en ' `true` para realizar un seguimiento del despliegue de los cambios de código mediante la creación de etiquetas, tags y comentarios en commits, pull requests y cuestiones referenciadas.
id_git	opcional, inmutable	Serie	id_git	Establezca este valor en `github` para github.com, o en el GUID de un servidor GitHub Enterprise personalizado.
has_issues	opcional, actualizable, " `Default: true`	Boolean	toolchain_issues_enabled	Establezca este valor en `true` para habilitar los problemas en el repositorio GitHub y añadir una tarjeta de herramienta Problemas a la cadena de herramientas. Establezca el valor en `false` para eliminar la tarjeta de integración de herramientas de la cadena de herramientas. Este valor no afecta a si los problemas están habilitados en el propio repositorio GitHub.
propietario_integración	opcional, actualizable	Serie	propietario_integración	Seleccione el usuario con el que se realizan las operaciones Git.
owner_id	opcional, inmutable	Serie	owner_id	El usuario u organización de GitHub propietario del repositorio. Este parámetro es necesario al crear un repositorio, o clonar o bifurcar un repositorio. Este valor se calcula cuando se enlaza a un repositorio existente.
private_repo	opcional, inmutable, " `Default: false`	Boolean	private_repo	Establezca este valor en `true` para que el repositorio sea privado al crear un repositorio o clonar o bifurcar un repositorio. Este parámetro no se utiliza cuando se enlaza a un repositorio existente.
id_reposición	opcional, inmutable	Serie	id_reposición	El ID del repositorio GitHub.
repo_name	opcional, inmutable	Serie	repo_name	El nombre del repositorio GitHub que se va a crear. Este parámetro es necesario al crear un repositorio, o clonar o bifurcar un repositorio. Este valor se calcula cuando se enlaza a un repositorio existente.
repo_url	opcional, inmutable	Serie	repo_url	El URL del repositorio GitHub para esta integración de herramientas. Este parámetro es necesario cuando se enlaza a un repositorio existente. Este valor se calcula al crear un repositorio, o clonar o bifurcar un repositorio.
url_raíz	opcional, actualizable	Serie	url_raíz	El URL raíz del servidor. por ejemplo, https://github.example.com
url_repo_origen	opcional, inmutable	Serie	url_repo_origen	El URL del repositorio que está bifurcando o clonando. Este parámetro es necesario cuando bifurca o clona un repositorio. No se utiliza al crear un repositorio o enlace a un repositorio existente.
título	opcional, actualizable	Serie	título	El título del servidor. por ejemplo, Mi servidor GitHub Enterprise
url_señal	opcional, actualizable	Serie	url_señal	El URL de señal que se utiliza para autorizar con el servidor GitHub.
tipo	necesario, inmutable	Serie	tipo	La operación que se debe realizar para inicializar la nueva integración de herramientas. Utilice `new` para crear un repositorio Git, `clone` para clonar un repositorio existente en un nuevo repositorio Git, `fork` para bifurcar un repositorio Git existente o `link` para enlazar a un repositorio Git existente.