Integración con GitHub

Open Build Service de openSUSE puede interactuar con GitHub, obteniendo y compilando el código fuente de cada commit o cada nueva publicación de versión o tag.

1. Cree una cuenta en GitHub.

2. Cree un repositorio (su aplicación): GitHub > Dashboard > + > New repository.

• Repository name: mauimusic

• Marque: Add a README file

• Eliga una licencia

3. Clone su repositorio en su carpeta de desarrollo. Si ya tiene un código preexistente haga copia del contenido a la nueva carpeta clonada:

cd /home/user/Devel/Apps
git clone https://github.com/user/mauimusic.git

4. Instale y haga login en GitHub:

sudo zypper install gh openssh-askpass-gnome
gh auth login

Seleccione:

• GitHub.com > HTTPS > Autenticate Git with your GitHub credentials > Login with a web browser.

• Copie el código de autenticación.

• Presione tecla Enter.

• Ingrese usuario y contraseña de GitHub

• Pege el código de autenticación.

• Clic botón Authorize github.

Configure su correo y nombre:

git config --global user.email "[email protected]"
git config --global user.name "tu nombre"

5. Haga su primer commit con el nuevo contenido:

cd /home/user/Devel/Apps/mauimusic
git add *
git commit -m "first commit"
git push origin main  

Para el segundo y siguientes commits:

cd /home/user/Devel/Apps/mauimusic
git add *
git commit -m "my commit"
git push 

6. Cree el token de acceso a GitHub.

GitHub > Dashboard > pulse sobre la imagen de perfil (superior derecha) > Settings > Developer settings > Personal access tokens > Tokens (classic) > Generate new token (classic)

• Note: GitHub Token

• Expiration: No expiration

• Scopes: todos

• Generate token

• Copie el nuevo token. No podrá verlo de nuevo, por lo que debe guardarlo.

7. Cree un token en Open Build Service.

Your Home Project > pulse sobre la imagen de perfil (superior derecha) > Your profile > Manage Your Tokens > Create Token >

• Type: workflow

• Description: OBS Personal Access Token

• SCM Token: pega el token de GitHub obtenido en el punto 6.

• Path for Workflows Configuration File (no modificar): .obs/workflows.yml

• Create

Apunte su OBS Personal Access Token:

• Secret: Copie y guarde.

• Token trigger url: Copie y guarde.

8. Cree en GitHub un webhook para su aplicación.

Seleccione:

• GitHub > click sobre imagen de perfil (superior derecha) > Your repositories > su aplicación (mauimusic)

• De las opciones superiores (code, Issues, Pull requests...) seleccione: Settings > Webhooks > Add webhook

  • Payload URL: Pegar su "Token trigger url" del punto 7.

  • Content type: application json

  • Secret: Pegar su "Secret" del punto 7.

  • Seleccione: Send me everything.

  • Add webhook.

9. Crear .obs/workflows.yml

• Abra la página de código de su aplicación (mauimusic): Selecciones Code o click sobre imagen de perfil (superior derecha) > Your repositories > su aplicación (mauimusic).

• Add file > Create new file

  • Pegar en la caja de texto "mauimusic/Name your file". Sustituya Name your file por: .obs/workflows.yml

  • Creará la carpeta oculta ".obs" y el archivo workflows.yml a la vez.

Incluya como contenido de workflows.yml:

rebuild_master:
    steps:
        - rebuild_package:
            project: home:usuario:subproyecto1
            package: mauimusic
    filters:
    event: push
workflow:
  steps:
    - branch_package:
        source_project: home:usuario
        source_package: mauimusic
        target_project: home:usuario:subproyecto2
  filters:
    event: tag_push 

En el archivo anterior se ha incluido:

• rebuild_master: para compilar cada commit en subproyecto1 y paquete mauimusic.

• workflow: para compilar cada nueva publicación de versión o tag de su aplicación en subproyecto2 y paquete mauimusic.

Haga clic en Commit changes > Commit changes.

10. Descarge los cambios a su carpeta local:

cd /home/user/Devel/Apps/mauimusic
git pull

11. Para compilar cada commit:

• Si no lo ha hecho, cree su paquete subproyecto1 > su paquete.

• Paquete > Add an empty file or service > File URL e indique la URL de cualquier archivo online. Es necesario para crear un servicio (fichero _service) válido. Por ejemplo, File URL: https://invent.kde.org/maui/mauikit/-/archive/master/mauikit-master.tar.gz

• Abra Subproyecto1 > Paquete > _service e incluya:

<?xml version="1.0"?>
<services>
  <service name="obs_scm">
    <param name="scm">git</param>
    <param name="url">https://github.com/user/mauimusic.git</param>
    <param name="revision">main</param>
    <param name="versionformat">0.1+git%cd.%h</param>
    <param name="filename">mauimusic</param>
    <param name="changesgenerate">enable</param>
  </service>
  <service name="tar" mode="buildtime"/>
  <service name="recompress" mode="buildtime">
    <param name="file">*.tar</param>
    <param name="compression">gz</param>
  </service>
  <service name="set_version" mode="buildtime"/>
</services>

Sustituya user y mauimusic.

• Añada mauimusic.spec o supaquete.spec

%define mauikit_version 3.0.1

Name:           mauimusic
Version:        0.1.0
Release:        0
License:        LGPL-3.0
Summary:        Discover and listen music
URL:            https://github.com/user/mauimusic
Source:         %{name}-%{version}.tar.gz

%if 0%{?sle_version} == 150400 && 0%{?is_opensuse} 
ExcludeArch: x86_64
%endif

%if 0%{?sle_version} == 150500 && 0%{?is_opensuse} 
ExcludeArch: x86_64
%endif

BuildRequires:  gcc-c++
BuildRequires:  cmake
BuildRequires:  extra-cmake-modules
BuildRequires:  fdupes
BuildRequires:  AppStream

BuildRequires:  cmake(Qt5QuickCompiler)
BuildRequires:  cmake(Qt5Core)
BuildRequires:  cmake(Qt5Quick)
BuildRequires:  cmake(Qt5Qml)
BuildRequires:  cmake(Qt5Widgets)

BuildRequires:  cmake(KF5I18n)
BuildRequires:  cmake(KF5CoreAddons)

BuildRequires:  cmake(MauiKit) = %{mauikit_version}
BuildRequires:  cmake(MauiKitFileBrowsing) = %{mauikit_version}

Requires:       qt5qmlimport(QtQuick.Controls.2)
Requires:       qt5qmlimport(QtQuick.Layouts.1)

Requires:       mauikit = %{mauikit_version}
Requires:       mauikit-filebrowsing = %{mauikit_version}

%description
Discover and listen music.

%prep
%autosetup -p1

%build
%cmake_kf5 -d build
%cmake_build

%install
%kf5_makeinstall -C build
%kf5_post_install
%fdupes %{buildroot}%{_prefix}

%files
%license licenses/*
%doc README.md
%{_bindir}/mauimusic
%{_datadir}/applications/*.desktop
%{_datadir}/metainfo/*.xml
%{_datadir}/icons/hicolor/*/*/*

%changelog

Para actualizar:

Open Build Service > Subproyecto > Paquete > Trigger services

12. Para compilar cada nueva versión o tag de su aplicación:

Para publicar una nueva versión en GitHub:

cd /home/user/Devel/Apps/mauimusic
git tag -a v0.1.0 -m "Releasing version v0.1.0"
git push origin v0.1.0

Crear Subproyecto2 > su paquete > _service como en el punto 11 e incluir:

<?xml version="1.0"?>
<services>
  <service name="obs_scm">
    <param name="versionformat">@PARENT_TAG@</param>
    <param name="url">https://github.com/user/mauimusic.git</param>
    <param name="scm">git</param>
    <param name="revision">@PARENT_TAG@</param>
  </service>
  <service name="tar" mode="buildtime"/>
  <service name="recompress" mode="buildtime">
    <param name="file">*.tar</param>
    <param name="compression">gz</param>
  </service>
  <service name="set_version" mode="buildtime"/>
</services>

Para actualizar:

Open Build Service > Subproyecto > Paquete > Trigger service