• 备份基础组件及服务

    备份Chartmuseum

    1. 中断外部访问

      • 修改Service

        kubectl edit svc <service name> -n <namespace>
        
      • ports.port字段修改为其他非8080任意端口后并保存

            ports:
            - name: http
              port: 12480
        
    2. 备份配置

      helm get values chartmuseum > chartmuseum-helm-values.yaml
      
    3. 备份数据

      将挂载的所有目录数据备份,默认使用 NFS 存储,chartmuseum-pvc 挂载的目录是 /nfs/mount/path/<namespace>-<pvc name>-<pvc volume>

      tar -cvzf chartmuseum.tar.gz -C /path/to/chartmuseum-pvc .
      

      之后将打包的备份文件保存即可,这里使用 scp 命令下载备份文件的到本地。

      scp root@remote_ip:/backup/path/chartmuseum.tar.gz chartmuseum.tar.gz
      
    4. 恢复外部访问

      • 修改Service

        kubectl edit svc <service name> -n <namespace>
        
      • ports.port字段修改为8080

            ports:
            - name: http
              port: 8080
        

    备份minio

    1. 中断外部访问

      • 修改Service

        kubectl edit svc <service name> -n <namespace>
        
      • ports.port字段修改为其他非9000任意端口后并保存

            ports:
            - name: http
              port: 12480
        
    2. 备份配置

      helm get values minio > minio-helm-values.yaml
      
    3. 备份数据

      将挂载的所有目录数据备份,默认使用 NFS 存储,minio-pvc 挂载的目录是 /nfs/mount/path/<namespace>-<pvc name>-<pvc volume>

      tar -cvzf minio.tar.gz -C /path/to/minio-pvc .
      

      之后将打包的备份文件保存即可。

    4. 恢复外部访问

      • 修改Service

        kubectl edit svc <service name> -n <namespace>
        
      • ports.port字段修改为9000

            ports:
            - name: http
              port: 9000
        

    备份Harbor

    该组件备份不完善,请谨慎操作。
    1. 中断外部访问

      • 备份Harbor Ingress

        kubectl get ing <ingress name> -n <namespace> -o yaml --export > harbor-ingress.yaml
        
      • 临时删除Harbor Ingress

        kubectl delete ing <ingress name> -n <namespace>
        
    2. 备份配置

      helm get values harbor > harbor-helm-values.yaml
      
    3. 备份数据库

      默认安装的 PostgreSQL 数据库是 ClusterIP模式,你可以修改成 NodePort 模式直接访问备份。

      • 修改 harbor-harbor-database

        kubectl edit svc <mysql svc name> -n <namespace>
        
      • 修改 spec.type ,添加 type.ports.nodePort

            spec:
              type: NodePort
              ports:
              - nodePort: 30306
        

      使用其他工具备份数据库 registry,notarysigner,notaryserver。

    4. 备份镜像

      使用 harbor 的镜像负责管理功能迁移镜像。Harbor 镜像复制功能

      也可以参照下一步直接打包备份 harbor-registry-pvc 目录

    5. 冗余数据备份

      将挂载的所有目录数据备份,默认使用 NFS 存储,会挂载 4 个 PVC,分别是 database-data-harbor-harbor-database-0、harbor-harbor-jobservice、harbor-harbor-registry,挂载目录的格式是 /nfs/mount/path/<namespace>-<pvc name>-<pvc value>。我们需要将除了 redis 之外的所有 PVC 文件夹备份。

      tar -cvzf harbor-database.tar.gz -C /path/to/harbor-database-pvc .
      
      tar -cvzf harbor-registry.tar.gz -C /path/to/harbo-registry-pvc .
      
      tar -cvzf harbor-jobservice.tar.gz -C  /path/to/harbor-jobservice-pvc .
      
      tar -cvzf harbor-redis.tar.gz -C /path/to/harbor-redis-pvc .
      
    6. 备份密钥

      • 获取存储证书的 secret 的名字

        kubectl get secret
        
      • 导出 secret

        kubectl get secret <secret-name-from-step-1> -o yaml > secret.yaml
        
    7. 恢复访问

      kubectl apply -f harbor-ingress.yaml -n <namespace>
      

    参考文档

    安装文档

    备份Gitlab

    1. 中断外部访问

      • 修改Gitlab Service

        kubectl edit svc <gitlab svc name> -n <namespace>
        
      • ports.port字段修改为其他非80、22任意端口后并保存

            ports:
            - name: http
              port: 12480
        
    2. 备份配置

      helm get values gitlab  > gitlab-helm-values.yaml
      
    3. 创建备份

      • 进入Gitlab容器

        kubectl exec -it <gitlab pod name> -n <namespace> bash
        
      • 完整备份命令

        gitlab-rake gitlab:backup:create RAILS_ENV=production
        
      • 备份CI私钥文件

        cp /etc/gitlab/gitlab-secrets.json /var/opt/gitlab/backups/
        
      • 备份 SSH 密钥

        # 查看需要备份的文件
        cat sshd_config | grep HostKey
        # 移动到 backup 目录
        cp /etc/ssh/ssh_host_rsa_key /var/opt/gitlab/backups/
        cp /etc/ssh/ssh_host_dsa_key /var/opt/gitlab/backups/
        cp /etc/ssh/ssh_host_ecdsa_key /var/opt/gitlab/backups/
        cp /etc/ssh/ssh_host_ed25519_key /var/opt/gitlab/backups/
        
      • 从容器中复制出备份文件

      kubectl cp <namespaces>/<gitlab pod name>:/var/opt/gitlab/backups/ ./gitlab_backup
      

      gitlab 备份与恢复

      ssh 备份

    4. 恢复访问

      • 修改Gitlab Service

        kubectl edit svc <gitlab svc name> -n <namespace>
        
      • ports.port字段修改为80

            ports:
            - name: http
              port: 80
        

    备份Choerodon

    备份前请按照 启动文档 停止需要备份的应用,备份完成之后启动应用。

    备份数据库

    默认安装的 MySQL 数据库是 ClusterIP模式,你可以修改成 NodePort 模式直接访问备份。

    1. 微服务开发框架数据备份

      # manager servcie
      mysqldump -u<username> -p<password> -h<host> --databases manager_service | gzip >$(date "+manager_service-%s.sql.gz")
      
      # iam servcie
      mysqldump -u<username> -p<password> -h<host> --databases iam_service | gzip >$(date "+iam_service-%s.sql.gz")
      
      # asgard service
      mysqldump -u<username> -p<password> -h<host> --databases asgard_service | gzip >$(date "+asgard_service-%s.sql.gz")
      
      #notify servcie
      mysqldump -u<username> -p<password> -h<host> --databases  notify_service | gzip >$(date "+notify_service-%s.sql.gz")
      
    2. 持续交付数据库备份

      # devops servcie
      mysqldump -u<username> -p<password> -h<host> --databases  devops_service | gzip >$(date "+devops_service-%s.sql.gz")
      
      # gitlab service
      mysqldump -u<username> -p<password> -h<host> --databases  gitlab_service | gzip >$(date "+gitlab_service-%s.sql.gz")
      
      # workflow_service
      mysqldump -u<username> -p<password> -h<host> --databases  workflow_service | gzip >$(date "+workflow_service-%s.sql.gz")
      
    3. 敏捷管理数据库备份

      # agile service
      mysqldump -u<username> -p<password> -h<host> --databases  agile_service | gzip >$(date "+agile_service-%s.sql.gz")
      
      # state machine service
      mysqldump -u<username> -p<password> -h<host> --databases  state_machine_service | gzip >$(date "+state_machine_service-%s.sql.gz")
      
      # issue service
      mysqldump -u<username> -p<password> -h<host> --databases  issue_service | gzip >$(date "+issue_service-%s.sql.gz")
      
      # foundation service
      mysqldump -u<username> -p<password> -h<host> --databases  foundation_service | gzip >$(date "+foundation_service-%s.sql.gz")
      
    4. 测试管理数据库备份

      # test manager service
      mysqldump -u<username> -p<password> -h<host> --databases  test_manager_service | gzip >$(date "+test_manager_service-%s.sql.gz")
      
    5. 知识管理数据备份

      # knowledgebase service
      mysqldump -u<username> -p<password> -h<host> --databases  knowledgebase-service | gzip >$(date "+knowledgebase-service-%s.sql.gz")
      

    备份配置

    1. 猪齿鱼开发框架组件和服务配置备份

      • register server 配置备份

        helm get values register-server > register-server-helm-values.yaml
        
      • asgard service 配置备份

        helm get values asgard-service > asgard-service-helm-values.yaml
        
      • manager service 配置备份

         helm get values manager-service > manager-service-helm-values.yaml
      
      • notify service 配置备份

        helm get values notify-service > notify-service-helm-values.yaml
        
      • iam servcie 配置备份

        helm get values iam-service > iam-server-helm-values.yaml
      
      • api gateway 配置备份

        helm get values api-gateway > api-gateway-helm-values.yaml
        
      • oauth server 配置备份

        helm get values oauth-server > oauth-server.yaml
        
      • file service 配置备份

        helm get values file-service > file-service-helm-values.yaml
        
    2. 持续交付组件与服务配置备份

      • devops-service 配置备份

        helm get values devops-service > devops-service-helm-value.yaml
        
      • gitlab servcie 配置备份

        helm get values gitlab-service > gitlab-servcie-helm-values.yaml
        
      • workflow servcie 配置备份

        helm get values workflow-service > workflow-servcie-helm-values.yaml
        
    3. 敏捷管理组件与服务配置备份

      • agile service 配置备份

        helm get values agile-service > agile-service-helm-values.yaml
        
      • state machine service 配置备份

        helm get values state-machine-service > state-machine-service-helm-values.yaml
        
      • issue service 配置备份

        helm get values issue-service > issue-service-helm-values.yaml
        
      • foundation service 配置备份

        helm get values foundation-service  > foundation-service-helm-values.yaml
        
    4. 测试管理组件与服务配置备份

      • test manager service 配置备份

        helm get values test-manager-service > test-manager-service-helm-values.yaml
        
    5. 知识管理组件与服务配置备份

      • knowledgebase service 配置备份

        helm get values knowledgebase-service > knowledgebase-service-helm-values.yaml
        
    6. 总前端配置备份

      • choerodon front 配置备份

        helm get values choerodon-front > choerodon-front-helm-values.yaml
        

    恢复基础组件及服务

    恢复Chartmuseum

    1. 恢复前确认 chartmuseum-pvc 已经创建。若没有创建,请先创建 chartmuseum-pvc。之后复制备份文件到挂载目录

      tar -xzvf chartmuseum.tar.gz -C /path/to/chartmuseum-pvc
      
    2. 恢复配置

      helm upgrade --install chartmuseum c7n/chartmuseum -f chartmuseum-helm-values.yaml
      

    恢复minio

    1. 恢复前确认 minic-pvc 已经创建。若没有创建,请先创建 minic-pvc。之后复制备份文件到挂载目录

      tar -xzvf minio.tar.gz -C /path/to/minio-pvc
      
    2. 恢复配置

      helm upgrade --install minio c7n/minio -f minio-helm-values.yaml
      

    恢复Harbor

    1. 将备份的数据库导入
    2. 证书配置参考 harbor 证书配置,恢复证书。

    3. 迁移回同步的镜像 Harbor 镜像复制功能,也可将备份的 harbor-registry.tar.gz 解压到 /path/to/harbor-registry-pvc 下。

    4. 恢复配置

      helm upgrade --install harbor c7n/harbor -f harbor-helm-values.yaml
      

    恢复Gitlab

    1. 使用 Helm chart 安装的Gitlab

      • 确保 gitlab 实例存在

        kubectl get pods -n <namespaces> | grep gitlab
        
      • 复制备份文件到容器中

        kubectl cp gitlab_backup/ <namespaces>/<pod name>:/var/opt/gitlab/backups/
        
      • 恢复

        进入Gitlab容器

        kubectl exec -it <gitlab pod name> -n <namespace> bash
        

        移动备份文件到 backups 目录

        cp /var/opt/gitlab/backups/gitlab_backup/*gitlab_backup.tar /var/opt/gitlab/backups/
        

        将你备份的ssh文件恢复到配置目录

        cp /var/opt/gitlab/backups/gitlab_backup/ssh_host* /etc/ssh/
        

        将你备份的私钥文件复制到配置目录

        cp /var/opt/gitlab/backups/gitlab_backup/gitlab-secrets.json /etc/gitlab/gitlab-secrets.json
        

        恢复gitlab

        # 备份的所有者必须是 git
        chown git.git /var/opt/gitlab/backups/1563811217_2019_07_23_11.6.11_gitlab_backup.tar
        
        # 还原指定时间戳的备份
        gitlab-rake gitlab:backup:restore BACKUP=1563811217_2019_07_23_11.6.11
        
        • 重启Gitlab
        kubectl delete po <gitlab pod name> -n <namespace>
      

      参考文档

    恢复Choerodon

    恢复数据库

    1. 微服务开发框架数据恢复

      # manager servcie
      gunzip manager_service-<date>.sql.gz | mysql -u<username> -p<password> --databases manager_service
      
      # iam servcie
      gunzip iam_service-<date>.sql.gz | mysql -u<username> -p<password> --databases iam_service
      
      # asgard service
      gunzip asgard_service-<date>.sql.gz | mysql -u<username> -p<password> --databases asgard_service
      
      #notify servcie
      gunzip notify_service-<date>.sql.gz | mysql -u<username> -p<password> --databases notify_service
      
    2. 持续交付数据库恢复

      # devops servcie
      gunzip devops_service-<date>.sql.gz | mysql -u<username> -p<password> --databases devops_service
      
      # gitlab service
      gunzip gitlab_service-<date>.sql.gz | mysql -u<username> -p<password> --databases gitlab_service
      
      # workflow_service
      gunzip workflow_service-<date>.sql.gz | mysql -u<username> -p<password> --databases workflow_service
      
    3. 敏捷管理数据库恢复

      # agile service
      gunzip agile_service-<date>.sql.gz | mysql -u<username> -p<password> --databases agile_service
      
      # state machine service
      gunzip state_machine_service-<date>.sql.gz | mysql -u<username> -p<password> --databases state_machine_service
      
      # issue service
      gunzip issue_service-<date>.sql.gz | mysql -u<username> -p<password> --databases issue_service
      
      # foundation service
      gunzip foundation_service-<date>.sql.gz | mysql -u<username> -p<password> --databases foundation_service
      
    4. 测试管理数据库恢复

      # test manager service
      gunzip test_manager_service-<date>.sql.gz | mysql -u<username> -p<password> --databases test_manager_service
      
    5. 知识管理数据恢复

      # knowledgebase service
      gunzip knowledgebase-service-<date>.sql.gz | mysql -u<username> -p<password> --databases knowledgebase-service
      

    配置恢复

    1. 猪齿鱼开发框架组件和服务配置

      • register server 配置恢复

        helm upgrade --install register-server c7n/register-server -f register-server-helm-values.yaml
        
      • asgard service 配置恢复

        helm upgrade --install asgard-service c7n/asgard-service -f asgard-service-helm-values.yaml
        
      • manager service 配置恢复

        helm upgrade --install manager-service c7n/manager-service -f manager-service-helm-values.yaml
        
      • notify service 配置恢复

        helm upgrade --install notify-service c7n/notify-service -f notify-service-helm-values.yaml
        
      • iam servcie 配置恢复

        helm upgrade --install iam-service c7n/iam-service -f iam-service-helm-values.yaml
      
      • api gateway 配置恢复

        helm upgrade --install api-gateway c7n/api-gateway -f api-gateway-helm-values.yaml
        
      • oauth server 配置恢复

        helm upgrade --install oauth-server c7n/oauth-server -f oauth-server-helm-values.yaml
        
      • file service 配置恢复

        helm upgrade --install file-service c7n/file-service -f file-service-helm-values.yaml
        
    2. 持续交付组件与服务配置恢复

      • devops-service 配置恢复

        helm upgrade --install devops-servcie c7n/devops-servcie -f devops-servcie-helm-values.yaml
        
      • gitlab servcie 配置恢复

        helm upgrade --install gitlab-servcie c7n/gitlab-servcie -f gitlab-servcie-helm-values.yaml
        
      • workflow servcie 配置恢复

        helm upgrade --install workflow-servcie c7n/workflow-servcie -f workflow-servcie-helm-values.yaml
        
    3. 敏捷管理组件与服务配置恢复

      • agile service 配置恢复

        helm upgrade --install agile-service c7n/agile-service -f agile-service-helm-values.yaml
        
      • state machine service 配置恢复

        helm upgrade --install state-machine-service c7n/state-machine-service -f state-machine-service-helm-values.yaml
        
      • issue service 配置恢复

        helm upgrade --install issue-service c7n/issue-service -f issue-service-helm-values.yaml
        
      • foundation service 配置恢复

        helm upgrade --install foundation-service c7n/foundation-service -f foundation-service-helm-values.yaml
        
    4. 测试管理组件与服务配置恢复

      • test manager service 配置恢复

        helm upgrade --install test-manager-service c7n/test-manager-service -f test-manager-service-helm-values.yaml
        
    5. 知识管理组件与服务配置恢复

      • knowledgebase service 配置恢复

        helm upgrade --install knowledgebase-service c7n/knowledgebase-service -f knowledgebase-service-helm-values.yaml
        
    6. 总前端配置恢复

      • choerodon front 配置恢复

        helm upgrade --install choerodon-front c7n/choerodon-front -f choerodon-front-helm-values.yaml