Tutorial: Firma de código de Apple con Fastlane en CodeBuild mediante GitHub para almacenamiento de certificados - AWS CodeBuild
Requisitos previosPaso 1: configuración de Fastlane Match con GitHub en el equipo localPaso 2: configuración del FastfilePaso 3: ejecución del comando fastlane match para generar los certificados y perfiles correspondientesPaso 4: creación del archivo de aplicación para el proyecto Paso 5: creación de variables de entorno en Secrets ManagerPaso 6: creación de una flota de computaciónPaso 7: creación de un proyecto en CodeBuildPaso 8: ejecutar la compilaciónSolución de problemasConsideraciones de seguridad

Tutorial: Firma de código de Apple con Fastlane en CodeBuild mediante GitHub para almacenamiento de certificados

fastlane es una conocida herramienta de automatización de código abierto para automatizar implementaciones y versiones beta de aplicaciones iOS y Android. Se encarga de todas las tareas tediosas, como generar capturas de pantalla, administrar la firma de código y publicar la aplicación.

En este ejemplo, se muestra cómo configurar la firma de código de Apple mediante Fastlane en un proyecto de CodeBuild que se ejecuta en una flota de Mac, con GitHub como almacenamiento de certificados y perfiles de aprovisionamiento.

Requisitos previos

Para completar este tutorial, debe configurar lo siguiente:

Paso 1: configuración de Fastlane Match con GitHub en el equipo local

Fastlane Match es una de las herramientas de Fastlane y permite la configuración perfecta para la firma de código tanto en el entorno de desarrollo local como en CodeBuild. Fastlane Match almacena todos los certificados de firma de código y perfiles de aprovisionamiento en un repositorio de Git, un bucket de S3 o Google Cloud Storage, y descarga e instala los certificados y los perfiles requeridos cuando es necesario.

En este ejemplo de configuración, configuraremos y usaremos un repositorio de Git para almacenamiento.

  1. Inicialice la coincidencia en el proyecto:

    fastlane match init

  2. Cuando se le solicite, elija GitHub como modo de almacenamiento.

  3. Actualice “Matchfile” para usar GitHub:

    git_url("https://github.com/your-username/your-certificate-repo.git")
storage_mode("git")
type("development") # The default type, can be: appstore, adhoc, enterprise or development
nota

Asegúrate de introducir la URL HTTPS del repositorio de Git para que fastlane se autentique y clone correctamente. De lo contrario, puede aparecer un error de autenticación al intentar utilizar coincidencia.

Paso 2: configuración del Fastfile

Cree o actualice el “Fastfile” con el siguiente flujo.

En CodeBuild, tendrá que ejecutar Fastlane Match cada vez que cree y firme la aplicación. La forma más sencilla de hacerlo es agregar la acción match al flujo que compila la aplicación.

default_platform(:ios)

platform :ios do
  before_all do
    setup_ci
  end
  
  desc "Build and sign the app"
  lane :build do
    match(type: "appstore", readonly: true)
    gym(
      scheme: "YourScheme",
      export_method: "app-store"
    )
  end
end
nota

Asegúrese de agregar setup_ci a la sección before_all de Fastfile para que la acción de búsqueda de coincidencias funcione correctamente. Esto garantiza el uso de un llavero de Fastlane temporal con los permisos adecuados. Si no lo usa, es posible que se produzcan errores de compilación o resultados incoherentes.

Paso 3: ejecución del comando fastlane match para generar los certificados y perfiles correspondientes

El comando fastlane match para el tipo indicado (por ejemplo, desarrollo, tienda de aplicaciones, adhoc, empresa) generará el certificado y el perfil si no están disponibles en el almacén remoto. Fastlane almacenará los certificados y los perfiles en GitHub.

bundle exec fastlane match appstore

La ejecución del comando será interactiva y fastlane solicitará establecer una frase de contraseña para descifrar los certificados.

Paso 4: creación del archivo de aplicación para el proyecto

Cree o agregue el archivo de aplicación que corresponda a su proyecto.

  1. Cree o agregue Gymfile, Appfile, Snapfile, Deliverfile en función de los requisitos de creación del proyecto.

  2. Confirmación de los cambios al repositorio remoto.

Paso 5: creación de variables de entorno en Secrets Manager

Cree tres secretos para almacenar la cookie de sesión de fastlane y la frase de contraseña coincidente. Para obtener información sobre cómo crear un secreto en Secrets Manager, consulte Creación de un secreto de AWS Secrets Manager.

  1. Acceda a la cookie de sesión de fastlane de la siguiente forma.

    1. Clave del secreto: FASTLANE_SESSION

    2. Valor secreto: cookie de sesión generada al ejecutar el siguiente comando en el equipo local.

      nota

      Este valor está disponible después de la autenticación en un archivo local: ~/.fastlane/spaceship/my_appleid_username/cookie.

      fastlane spaceauth -u <Apple_account>

  2. Frase de contraseña de Fastlane Match: para permitir que Fastlane Match descifre los certificados y los perfiles almacenados en el repositorio de Git es necesario agregar la frase de contraseña de cifrado que configuró en el paso de configuración de coincidencia a las variables de entorno del proyecto de CodeBuild.

    1. Clave del secreto: MATCH_PASSWORD

    2. Valor del secreto: <match passphrase to decrypt certificates> La frase de contraseña se establece al generar los certificados en el paso 3.

  3. Fastlane MATCH_GIT_BASIC_AUTHORIZATION: establezca una autorización básica para coincidencia:

    1. Clave del secreto:

      MATCH_GIT_BASIC_AUTHORIZATION

    2. Valor secreto: el valor debe ser una cadena codificada en base64 de su nombre de usuario y su token de acceso personal (PAT) en formato username:password. Puede generarlo utilizando el comando siguiente:

      echo -n your_github_username:your_personal_access_token | base64

      Puede generar su PAT en la consola de GitHub en Su perfil > Configuración > Configuración de desarrolladores > Token de acceso personal. Para obtener más información, consulte la siguiente guía: https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens.

nota

Al crear los secretos anteriores en Secrets Manager, recuerde dar un nombre de secreto con el siguiente prefijo: /CodeBuild/

Paso 6: creación de una flota de computación

Cree la flota de computación para el proyecto.

  1. En la consola, vaya a CodeBuild y cree una nueva flota de computación.

  2. Elija macOS como sistema operativo y seleccione un tipo de computación y una imagen adecuados.

Paso 7: creación de un proyecto en CodeBuild

Cree el proyecto en CodeBuild.

  1. Abra la consola de AWS CodeBuild en https://console.aws.amazon.com/codesuite/codebuild/home.

  2. Cree un proyecto de compilación. Para obtener más información, consulte Creación de un proyecto de compilación (consola) y Ejecutar una compilación (consola).

  3. Configure el proveedor de origen (por ejemplo, GitHub o CodeCommit). Este es el repositorio de origen de proyectos de iOS y no el repositorio de certificados.

  4. En Environment (Entorno):

    • Elija Capacidad reservada.

    • En Flota, seleccione la flota creada anteriormente.

    • Proporcione el nombre del rol de servicio que CodeBuild creará.

    • Proporcione las siguientes variables de entorno.

      • Nombre: MATCH_PASSWORD, Valor: <arn de secretos>, Tipo: Secrets Manager (ARN de secretos creado en el paso 5 para MATCH_PASSWORD)

      • Nombre: FASTLANE_SESSION, Valor: <arn de secretos>, Tipo: Secrets Manager (ARN de secretos creado en el paso 5 para FASTLANE_SESSION)

      • Nombre: MATCH_GIT_BASIC_AUTHORIZATION, Valor: <ARN de secretos>, Tipo: ARN de secretos de Secrets Manager (creado en el paso 5 para MATCH_GIT_BASIC_AUTHORIZATION)

  5. En Buildspec, agregue lo siguiente:

    version: 0.2

phases:
  install:
    commands:
      - gem install bundler
      - bundle install
  build:
    commands:
      - echo "Building and signing the app..."
      - bundle exec fastlane build
  post_build:
    commands:
      - echo "Build completed on date"

artifacts:
  files:
    - '*/.ipa'
  name: app-$(date +%Y-%m-%d)

Paso 8: ejecutar la compilación

Ejecute la compilación. Puede revisar el estado de compilación y los registros en CodeBuild.

Una vez que se haya completado el trabajo, podrá ver el registro de este.

Solución de problemas

  • Si tiene problemas para acceder al repositorio de GitHub, compruebe dos veces su token de acceso personal y la variable de entorno MATCH_GIT_BASIC_AUTHORIZATION.

  • Si tiene problemas al descifrar certificados, asegúrese de establecer la frase contraseña correcta en la variable de entorno MATCH_PASSWORD.

  • En caso de problemas con la firma de código, compruebe que la cuenta de desarrollador de Apple tiene los certificados y los perfiles necesarios y que el identificador de agrupación del proyecto de Xcode coincide con el del perfil de aprovisionamiento.

Consideraciones de seguridad

Tenga en cuenta los siguientes aspectos de seguridad en este tutorial.

  • Mantenga privado su repositorio de GitHub para certificados y audite el acceso con regularidad.

  • Considere usar AWS Secrets Manager para almacenar información confidencial, como MATCH_PASSWORD y FASTLANE_SESSION.

En este ejemplo se proporciona una configuración para la firma de código de iOS con Fastlane en CodeBuild mediante GitHub para almacenamiento de certificados. Es posible que deba ajustar algunos pasos en función de los requisitos específicos del proyecto y del entorno de CodeBuild. Este método aprovecha los servicios de AWS para mejorar la seguridad y la integración en el ecosistema de AWS.