Ansible Playbook: manage_gitlab_servers


Manage GitLab servers.

Supported features in the current version:

  • Configure OS package manager
    • Add GitLab repo
  • Provision OS Firewall
  • Provision GitLab server

Use Cases

Deploy GIT server node

  • Verify that target nodes are registered in the inventory file: gitlab_service.ini
  • Verify that target endstate is set: manage_gitlab_servers.yml
  • Run the playbook. Use the -s <SITE> parameter to select the target site.
/opt/aplatform64/bin/ -n -p manage_gitlab_servers -s <SITE>

Playbook Parameters


Register the hosts that will consume the service in the Ansible Inventory file:

  • File: inventories/<SITE>/gitlab_service.ini
  • Host Group: gitlab_server_nodes

End State

A dedicated group_vars directory is used to store end-state configuration settings for both the playbook and related Ansible Roles.

Set playbook specific settings in the file: inventories/<SITE>/group_vars/gitlab_server_nodes/manage_gitlab_servers.yml

Parameter Required? Type Default Purpose / Value
manage_gitlab_servers_apps no dictionary Define what applications will be deployed
manage_gitlab_servers_apps.gitlab no boolean true Deploy the application?

Additional role specific settings are available to further customize the playbook:

A:Platform64 role group_vars file
serdigital64.devops.dops_gitlab_server inventories/<SITE>/group_vars/gitlab_server_nodes/dops_gitlab_server.yml
serdigital64.system.sys_repository inventories/<SITE>/group_vars/gitlab_server_nodes/sys_repository.yml


OS Compatibility

OS compatibility is role dependant. Please refer to the respective role documentation.


Dependencies in this section are automatically solved during the installation of A:Platform64.

  • Ansible Collections:
    • serdigital64.backup
    • serdigital64.devops
    • serdigital64.system


  • Ansible:
    • Control Node: A:Platform64 installed and configured.
    • Managed Nodes: target hosts prepared for A:Platform64 control.

Installation Procedure

The playbook is automatically deployed during the A:Platform64 installation process.


Help on implementing new features and maintaining the code base is welcomed.

Please see the guidelines for further details.