forgerock/git

ForgeRock DevOps与云部署

ForgeRock平台的Docker和Kubernetes DevOps制品，用于支持平台的容器化部署与管理。

免责声明

这些示例按"原样"提供，不提供任何形式的担保，在***允许的最大范围内。ForgeRock不保证开发者在其开发平台或生产配置中实施代码的成功。ForgeRock不对这些示例相关的数据或信息的使用、使用结果、准确性、及时性或完整性作出任何陈述或保证。ForgeRock免除所有明示或暗示的保证，特别是免除所有适销性保证以及与代码或相关服务、软件有关的保证。ForgeRock不对因您或他人就示例采取的任何行动而产生的任何直接、间接或后果性损害或费用承担责任。

分支

master分支针对仍在开发中的功能，可能不稳定。请检出与目标版本匹配的分支。

例如，若已从git检出源代码：

bash
git checkout release/6.0.0

Docker镜像

Docker镜像在docker/文件夹中维护。

有权访问ForgeRock private-releases Artifactory仓库的客户和合作伙伴，可使用dl.sh下载产品二进制文件，并通过build.sh脚本构建Docker镜像。从Artifactory下载二进制文件需API Key。

文档

Draft ForgeRock DevOps Guide跟踪master分支。

当前版本的文档可在backstage查看。

快速启动

• 假定您已具备Kubernetes和Helm知识。请先阅读https://github.com/kubernetes/helm/blob/master/docs/index.md%E3%80%82
• 假定minikube已运行（8G内存），且已安装helm和kubectl。
• 可参考bin/setup.sh示例设置脚本。

sh
# 构建所有Docker镜像
cd docker
eval $(minikube docker-env)
./dl.sh
./build.sh
cd ..

# 确保已启用ingress控制器插件
minikube addon enable ingress

helm init

# 复制helm/custom.yaml并根据环境编辑

cd helm/

# 若要使用演示Helm chart仓库，可执行：
helm repo add forgerock https://storage.googleapis.com/forgerock-charts/
helm repo update
# 部署平台示例：
helm install -f my-custom.yaml forgerock/cmp-platform

# 若从源代码运行helm charts：
./update-deps.sh   
helm install -f my-custom.yaml cmp-platform

# 获取minikube IP
minikube ip

# 可在/etc/hosts中添加DNS条目，例如：
# 192.168.99.100 openam.default.example.com openidm.default.example.com openig.default.example.com

open http://openam.default.example.com

# 或者，若使用xip.io，可通过minikube IP访问AM：
open http://openam.default.192.168.99.100.xip.io/openam

如需修改部署参数、FQDN等，请参考helm/custom.yaml中的注释。

目录内容

• docker/ - 包含各类容器的Dockerfile
• helm/ - 包含用于部署容器的Kubernetes helm图表，详见helm/README.md
• etc/ - 包含各类脚本和工具
• bin/ - 包含实用shell脚本

设置命名空间

若不想使用"default"命名空间，可通过以下命令设置：

kubectl config set-context $(kubectl config current-context) --namespace=<插入命名空间名称>