Gitlab部署

预备知识

如果你不知道Gitlab是做什么的，那么请参考下面链接（包括但不限于）进行学习：

Gitlab

仓库设置

添加choerodon chart仓库并同步

helm repo add c7n https://openchart.choerodon.com.cn/choerodon/c7n/
helm repo update

部署Gitlab

创建参数配置文件 gitlab.yaml

core:
  env:
    OAUTH_ENABLED: false
    OAUTH_AUTO_SIGN_IN_WITH_PROVIDER: "oauth2_generic"
    OAUTH_ALLOW_SSO: "'oauth2_generic'"
    OAUTH_BLOCK_AUTO_CREATED_USERS: false
    OAUTH_GENERIC_API_KEY: "gitlabhq"
    OAUTH_GENERIC_APP_SECRET: "gitlabhq"
    # choerodon api 访问地址
    OAUTH_GENERIC_SITE: "http://api.example.choerodon.io"
    OAUTH_GENERIC_USER_INFO_URL: "/oauth/api/user"
    OAUTH_GENERIC_AUTHORIZE_URL: "/oauth/oauth/authorize"
    OAUTH_GENERIC_TOKEN_URL: "/oauth/oauth/token"
    OAUTH_GENERIC_ROOT_PATH: "'userAuthentication','principal'"
    OAUTH_GENERIC_ID_PATH: "'userAuthentication','principal','userId'"
    OAUTH_GENERIC_USER_NICKNAME: "username"
    OAUTH_GENERIC_USER_NAME: "username"
redis:
  internal:
    password: password
persistence:
  enabled: true
  persistentVolumeClaim:
    core:
      storageClass: nfs-provisioner
    redis:
      storageClass: nfs-provisioner
    database:
      storageClass: nfs-provisioner
expose:
  ingress:
    host: "gitlab.example.choerodon.io"
database:
  internal:
    password: "password"

执行安装

helm upgrade --install gitlab c7n/gitlab-ha \
    -f gitlab.yaml \
    --create-namespace \
    --version 0.2.3 \
    --namespace c7n-system

参数

参数	含义	默认值
Expose
`expose.type`	暴露服务的方式：`ingress`、`ClusterIP`、`LoadBalancer`或`nodePort`	`ingress`
`expose.tls.enabled`	是否开启 TLS	`false`
`expose.ingress.host`	Gitlab 在 ingress 中的域名	`gitlab.cluster.local`
`expose.ingress.annotations`	ingress 中使用的注解
`expose.clusterIP.name`	ClusterIP 服务名	`Release.Name-gitlab-core`
`expose.clusterIP.ports.ssh`	Gitlab 监听的 service SSH 端口	`22`
`expose.clusterIP.ports.http`	Gitlab 监听的 service HTTP 端口	`80`
`expose.nodePort.name`	NodePort 服务名	`Release.Name-gitlab-core`
`expose.nodePort.ports.ssh.port`	Gitlab 监听的 service SSH 端口	`22`
`expose.nodePort.ports.ssh.nodePort`	Gitlab 监听的 service SSH nodePort	`30022`
`expose.nodePort.ports.http.port`	Gitlab 监听的 service HTTP 端口	`80`
`expose.nodePort.ports.http.nodePort`	Gitlab 监听的 service HTTP nodePort	`30007`
`expose.loadBalancer.name`	LoadBalancer 服务名	`Release.Name-gitlab-core`
`expose.loadBalancer.ports.ssh`	Gitlab 监听的 SSH 端口	`22`
`expose.loadBalancer.ports.http`	Gitlab 监听的 HTTP 端口	`80`
Persistence
`persistence.enabled`	是否开启持久化存储	`persistence.enabled`
`persistence.resourcePolicy`	将它设置成 `keep` 避免 helm delete 时删掉 PVC。	`keep`
`persistence.persistentVolumeClaim.core.existingClaim`	使用已经绑定 PV 的PVC，你使用共享的 PVC 必须指定 `subPath`
`persistence.persistentVolumeClaim.core.storageClass`	指定 `storageClass` 提供数据卷。如果有默认的 `storageClass` 会直接使用它，设置 `-` 禁用动态配置
`persistence.persistentVolumeClaim.database.existingClaim`	使用已经绑定 PV 的PVC，你使用共享的 PVC 必须指定 `subPath`
`persistence.persistentVolumeClaim.database.storageClass`	指定 `storageClass` 提供数据卷。如果有默认的 `storageClass` 会直接使用它，设置 `-` 禁用动态配置
`persistence.persistentVolumeClaim.redis.existingClaim`	使用已经绑定 PV 的PVC，你使用共享的 PVC 必须指定 `subPath`
`persistence.persistentVolumeClaim.redis.storageClass`	指定 `storageClass` 提供数据卷。如果有默认的 `storageClass` 会直接使用它，设置 `-` 禁用动态配置
General
`imagePullPolicy`	镜像拉取策略	`IfNotPresent`
Core
`core.image.repository`	gitlab 镜像地址	`registry.cn-shanghai.aliyuncs.com/c7n/docker-gitlab`
`core.image.tag`	镜像 tag	`v11.11.7`
`core.env.GITLAB_HOST`	Gitlab 主机名	`localhost`
`core.env.OAUTH_ENABLED`	是否启用 oauth 认证	`false`
`core.env.OAUTH_GENERIC_API_KEY`	oauth 客户端ID
`core.env.OAUTH_GENERIC_APP_SECRET`	oauth 客户端密钥
`core.env.OAUTH_GENERIC_SITE`	Gitlab 域名
`core.env.RACK_ATTACK_WHITELIST`	Gitlab 并发限制白名单	0.0.0.0/0
Database
`database.type`	如果使用外部数据库，设置为 `external`	`internal`
`database.internal.password`	数据库密码	`changeit`
`database.external.adapter`	外部数据库适配器	`postgresql`
`database.external.host`	外部数据主机名	`192.168.0.1`
`database.external.port`	外部数据库端口	`5432`
`database.external.username`	外部数据库用户
`database.external.password`	外部数据库密码
`database.external.databaseName`	Gitlab 数据的数据库	`gitlabhq_production`
Redis
`redis.type`	如果使用外部数据库，设置为 `external`	`internal`
`redis.internal.password`	Redis密码
`redis.external.host`	外部redis主机名	`192.168.0.2`
`redis.external.port`	外部redis端口	`6379`

验证部署

访问设置的Gitlab域名出现以下界面即部署成功

配置Choerodon Oauth认证

以下操作须将Choerodon搭建完成后再继续进行，若未搭建，请跳过。

配置Choerodon的Oauth认证后Gitlab的root用户是无法再通过Gitlab自有的界面进行登录的了。

如标题所描述，进行此步配置就是使用Choerodon的Oauth认证进行登陆Gitlab。这是Gitlab与Choerodon进行整合的必要操作。

更新Gitlab配置

修改参数配置文件 gitlab.yaml

core:
  env:
    OAUTH_ENABLED: true
...

执行更新

helm upgrade --install gitlab c7n/gitlab-ha \
    -f gitlab.yaml \
    --create-namespace \
    --version 0.2.3 \
    --namespace c7n-system

添加Gitlab Client

在执行里面前请根据实际情况修改参数 web_server_redirect_uri

编写参数配置文件 gitlab-client.yaml

env:
  MYSQL_HOST: c7n-mysql.c7n-system.svc
  MYSQL_PASS: password
  MYSQL_PORT: 3306
  MYSQL_USER: root
  SQL_SCRIPT: |
    INSERT INTO hzero_platform.oauth_client (name,organization_id,resource_ids,secret,scope,authorized_grant_types,web_server_redirect_uri,access_token_validity,refresh_token_validity,additional_information,auto_approve,object_version_number,created_by,creation_date,last_updated_by,last_update_date,enabled_flag,time_zone)VALUES('gitlabhq',1,'default','gitlabhq','default','password,implicit,client_credentials,authorization_code,refresh_token','http://gitlab.example.choerodon.io',3600,3600,'{}','default',1,0,NOW(),0,NOW(),1,'GMT+8');

部署服务

helm upgrade --install gitlab-client c7n/mysql-client \
    -f gitlab-client.yaml \
    --version 0.1.0 \
    --namespace c7n-system

添加管理员用户关联

执行完添加管理员用户关联步骤前请不要去Gitlab界面进行登录操作

执行下面语句进行关联:

helm upgrade --install gitlab-user-identities c7n/postgresql-client \
    --set env.PG_HOST=gitlabhq-gitlab-database.c7n-system.svc \
    --set env.PG_PORT=5432 \
    --set env.PG_USER=gitlab \
    --set env.PG_PASS=changeit \
    --set env.PG_DBNAME=gitlabhq_production \
    --set env.SQL_SCRIPT="\
        INSERT INTO identities(extern_uid\, provider\, user_id\, created_at\, updated_at) \
        VALUES ('2'\, 'oauth2_generic'\, 1\, NOW()\, NOW());" \
    --version 0.1.0 \
    --namespace c7n-system

验证更新

访问设置的Gitlab域名出现以下界面即更新成功