Before we do automated migrations via the API, you need to prepare your AAGM and set git as the single point of truth for your API.

Jenkins

Set up Jenkins

Copy this docker-compose.yml, adjust the ports and boot up your Jenkins!

Docker https://hub.docker.com/r/jenkins/jenkins

version: '3.6'
services:
  jenkins:
    image: jenkins/jenkins:lts
    extra_hosts:
      - "host.docker.internal:host-gateway"
    privileged: true
    user: root
    container_name: jenkins.apiida
    ports:
      - 50000:50000
      - 8033:8080
    volumes:
      - jenkins.apiida:/var/jenkins_home
      - ./secrets:/var/jenkins_home/secrets/
volumes:
  jenkins.apiida:

The initial password of the admin can be found either in the logs of the container or in the mounted folder secrets.

Needed Plugins

For our project we still need a few plugins.

http://localhost:8033/pluginManager/

https://plugins.jenkins.io/remote-file/

https://plugins.jenkins.io/pipeline-utility-steps/

HTTP Request

Connect to GitLab

http://localhost:8033/credentials/

Add your GitLab credentials as global Credentials

Setup Pipeline

Create a Multibranch Pipeline

Insert the Repository URL of ur API at “Branch Sources” and select your credentials.

If you want to have your Jenkinsfile in another repository, select "by Remote Jenkinsfile Provider Plugin" in "Build Configuration" instead of "by Jenkinsfile", then git in "Jenkinsfile SCM" and enter the repository URL of your Jenkinsfile there.

In "Scan Multibranch Pipeline Triggers", set the intervals at which Jenkins should check for updates in your repository.

Jenkinsfile

pipeline {

    agent any
    
    stages {
    
        stage("is AAGM alive?") {
        
            steps {
				script {
				    echo '------------------------------------------------'
					echo '---------------  is AAGM alive?  ---------------'
					echo '------------------------------------------------'
				
					def response = httpRequest "http://host.docker.internal:8090/api/v1/alive"
					println('Response: '+response.content)
				}
            }
        }
    
        stage("is AAGM ready?") {
        
            steps {
				script {
				    echo '------------------------------------------------'
				    echo '---------------  is AAGM ready?  ---------------'
				    echo '------------------------------------------------'
				
					def response = httpRequest "http://host.docker.internal:8090/api/v1/ready"
					println('Response: '+response.content)
				}
            }
        }
    
        stage("Login and Deploy") {
        
            steps {
				script {
				    echo '------------------------------------------'
				    echo '---------------  Login...  ---------------'
				    echo '------------------------------------------'
				    
				    def bodyLogin = '{"user": "mirco.hoffmann@apiida.com","pass": "myPassword"}'
				    def response = httpRequest contentType: 'APPLICATION_JSON', httpMode: 'POST', requestBody: "${bodyLogin}" , url: "http://host.docker.internal:8090/api/v1/login"
					println('Response Content: '+response.content)

                    echo '-------------------------------------------'
                    echo '---------------  Deploy...  ---------------'
                    echo '-------------------------------------------'

                    def jsonObj = readJSON text: response.content
                    echo 'Token: '+jsonObj.token 
				
				    def body = '{"source": {"type": "git"},"targets": ["myTargetNode"],"comment": "Test Migration over API"}'
					
					def migResponse = httpRequest customHeaders:[[name:'X-Token', value:"${jsonObj.token}"]] ,contentType: 'APPLICATION_JSON', httpMode: 'GET', requestBody: "${body}" , url: "http://host.docker.internal:8090/api/v1/apis/myApiId/migrate"
					println('Response: '+migResponse.content)
				}
            }
        }
    }
    
}

In line 54 you have to define the targets of the migration.

In line 56 you have to insert the id of the API you want to migrate.

That's it! Push something to git! And try it out!

APIIDA API Gateway Manager