镜像

流程

1. 导航到红帽客户门户网站上的 OpenShift Container Platform 下载页面。
2. 在产品变体下拉菜单中选择架构。
3. 在 Version 下拉菜单中选择相应的版本。
4. 点 OpenShift v4.11 Linux Client 条目旁的 Download Now 来保存文件。

5. 解包存档：

   $ tar xvf <file>

6. 将 oc 二进制文件放到 PATH 中的目录中。

   要查看您的 PATH，请执行以下命令：

   $ echo $PATH

流程

1. 导航到红帽客户门户网站上的 OpenShift Container Platform 下载页面。
2. 在 Version 下拉菜单中选择相应的版本。
3. 点 OpenShift v4.11 Windows Client 条目旁的 Download Now 来保存文件。
4. 使用 ZIP 程序解压存档。

5. 将 oc 二进制文件移到 PATH 中的目录中。

   要查看您的 PATH，请打开命令提示并执行以下命令：

   C:\> path

流程

1. 导航到红帽客户门户网站上的 OpenShift Container Platform 下载页面。
2. 在 Version 下拉菜单中选择相应的版本。

3. 点 OpenShift v4.11 macOS Client 条目旁的 Download Now 来保存文件。

   注意

   对于 macOS arm64，请选择 OpenShift v4.11 macOS arm64 Client 条目。

4. 解包和解压存档。

5. 将 oc 二进制文件移到 PATH 的目录中。

   要查看您的 PATH，请打开终端并执行以下命令：

   $ echo $PATH

1. 构建配置中指定的脚本。
2. 在应用程序源 .s2i/bin 目录中找到的脚本。
3. 在默认镜像 URL 中找到的带有 io.openshift.s2i.scripts-url 标签的脚本。

1. 验证 usage 脚本是否正在工作：

   • 如果使用 Podman，请运行以下命令：

     $ podman run <builder_image_name> .

   • 如果使用 Docker，请运行以下命令：

     $ docker run <builder_image_name> .

2. 构建镜像：

   $ s2i build file:///path-to-sample-app _<BUILDER_IMAGE_NAME>_ _<OUTPUT_APPLICATION_IMAGE_NAME>_

3. 可选：如果支持 save-artifacts，请再次运行第 2 步，验证保存和恢复工件是否正常工作。

4. 运行容器：

   • 如果使用 Podman，请运行以下命令：

     $ podman run <output_application_image_name>

   • 如果使用 Docker，请运行以下命令：

     $ docker run <output_application_image_name>

5. 验证容器是否正在运行，应用程序是否有所反应。

1. 如果标签为 latest，OpenShift Container Platform 会将 imagePullPolicy 默认设置为 Always。
2. 否则，OpenShift Container Platform 会将 imagePullPolicy 默认设置为 IfNotPresent。

流程

1. 要允许 project-a 中的 pod 引用 project-b 中的镜像，请将 project-a 中的服务帐户绑定到 project-b 中的 system:image-puller 角色。

   $ oc policy add-role-to-user \
       system:image-puller system:serviceaccount:project-a:default \
       --namespace=project-b

   添加该角色后，project-a 中引用默认服务帐户的 pod 能够从 project-b 拉取（pull）镜像。

2. 要允许访问 project-a 中的任意服务帐户，请使用组：

   $ oc policy add-role-to-group \
       system:image-puller system:serviceaccounts:project-a \
       --namespace=project-b

流程

1. 可选： 要将新的 pull secret 附加到现有 pull secret 中，请完成以下步骤：

   1. 输入以下命令下载 pull secret：

      $ oc get secret/pull-secret -n openshift-config --template='{{index .data ".dockerconfigjson" | base64decode}}' ><pull_secret_location> 1

      1

      提供 pull secret 文件的路径。

   2. 输入以下命令来添加新 pull secret：

      $ oc registry login --registry="<registry>" \ 1
      --auth-basic="<username>:<password>" \ 2
      --to=<pull_secret_location> 3

      1

      提供新的 registry。您可以在同一个 registry 中包含多个软件仓库，例如：--registry="<registry/my-namespace/my-repository>"。

      2

      提供新 registry 的凭据。

      3

      提供 pull secret 文件的路径。

      另外，您可以对 pull secret 文件执行手动更新。

2. 输入以下命令为您的集群更新全局 pull secret：

   $ oc set data secret/pull-secret -n openshift-config --from-file=.dockerconfigjson=<pull_secret_location> 1

   1

   提供新 pull secret 文件的路径。

   该更新将推广至所有节点，可能需要一些时间，具体取决于集群大小。

   注意

   从 OpenShift Container Platform 4.7.4 开始，对全局 pull secret 的更改不再触发节点排空或重启。

流程

1. 调度导入镜像：

   $ oc tag <repository/image> <image-name:tag> --scheduled

   例如：

   $ oc tag docker.io/python:3.6.0 python:3.6 --scheduled

   输出示例

   Tag python:3.6 set to import docker.io/python:3.6.0 periodically.

   该命令可使 OpenShift Container Platform 定期更新该特定镜像流标签。此周期是集群范围的设置，默认设为 15 分钟。

2. 删除定期检查，重新运行上述命令，但忽略 --scheduled 标志。这会将其行为重置为默认值。

   $ oc tag <repositiory/image> <image-name:tag>

流程

1. 编辑 image.config.openshift.io/cluster CR:

   $ oc edit image.config.openshift.io/cluster

   以下是一个带有允许列表的 image.config.openshift.io/cluster CR 示例：

   apiVersion: config.openshift.io/v1
   kind: Image
   metadata:
     annotations:
       release.openshift.io/create-only: "true"
     creationTimestamp: "2019-05-17T13:44:26Z"
     generation: 1
     name: cluster
     resourceVersion: "8302"
     selfLink: /apis/config.openshift.io/v1/images/cluster
     uid: e34555da-78a9-11e9-b92b-06d6c7da38dc
   spec:
     registrySources: 1
       allowedRegistries: 2
       - example.com
       - quay.io
       - registry.redhat.io
       - reg1.io/myrepo/myapp:latest
       - image-registry.openshift-image-registry.svc:5000
   status:
     internalRegistryHostname: image-registry.openshift-image-registry.svc:5000

   1

   包含用于决定容器运行时在访问构建和 pod 的镜像时应如何处理个别 registry 的配置。它不包含内部集群 registry 的配置。

   2

   指定 registry 以及该 registry 中的存储库（可选）用于镜像拉取（pull）和推送（push）操作。阻止所有其他 registry。

   注意

   可以设置 allowedRegistries 参数或 blockedRegistries 参数，但不能同时设置这两个参数。

   Machine Config Operator（MCO）会监控 image.config.openshift.io/cluster 资源以了解对 registry 的任何更改。当 MCO 检测到更改时，它会排空节点，应用更改，并对节点进行 uncordon 处理。节点返回 Ready 状态后，允许的 registry 列表用于更新每个节点上的 /etc/containers/policy.json 文件中的镜像签名策略。

流程

1. 编辑 image.config.openshift.io/cluster CR:

   $ oc edit image.config.openshift.io/cluster

   以下是一个带有块列表的 image.config.openshift.io/cluster CR 示例：

   apiVersion: config.openshift.io/v1
   kind: Image
   metadata:
     annotations:
       release.openshift.io/create-only: "true"
     creationTimestamp: "2019-05-17T13:44:26Z"
     generation: 1
     name: cluster
     resourceVersion: "8302"
     selfLink: /apis/config.openshift.io/v1/images/cluster
     uid: e34555da-78a9-11e9-b92b-06d6c7da38dc
   spec:
     registrySources: 1
       blockedRegistries: 2
       - untrusted.com
       - reg1.io/myrepo/myapp:latest
   status:
     internalRegistryHostname: image-registry.openshift-image-registry.svc:5000

   1

   包含用于决定容器运行时在访问构建和 pod 的镜像时应如何处理个别 registry 的配置。它不包含内部集群 registry 的配置。

   2

   指定 registry，并可选择性地指定 registry 中的存储库，以使它们不应该用于镜像拉取（pull）和推送（push）操作。允许所有其他 registry。

   注意

   可以设置 blockedRegistries registry 或 allowedRegistries registry，但不能同时设置这两个 registry。

   Machine Config Operator（MCO）会监控 image.config.openshift.io/cluster 资源以了解对 registry 的任何更改。当 MCO 检测到更改时，它会排空节点，应用更改，并对节点进行 uncordon 处理。节点返回 Ready 状态后，在每个节点上的 /etc/containers/registries.conf 文件中会显示对被阻断的 registry 的更改。

流程

1. 编辑 image.config.openshift.io/cluster CR:

   $ oc edit image.config.openshift.io/cluster

   以下是一个带有不安全 registry 列表的 image.config.openshift.io/cluster CR 示例：

   apiVersion: config.openshift.io/v1
   kind: Image
   metadata:
     annotations:
       release.openshift.io/create-only: "true"
     creationTimestamp: "2019-05-17T13:44:26Z"
     generation: 1
     name: cluster
     resourceVersion: "8302"
     selfLink: /apis/config.openshift.io/v1/images/cluster
     uid: e34555da-78a9-11e9-b92b-06d6c7da38dc
   spec:
     registrySources: 1
       insecureRegistries: 2
       - insecure.com
       - reg4.io/myrepo/myapp:latest
       allowedRegistries:
       - example.com
       - quay.io
       - registry.redhat.io
       - insecure.com 3
       - reg4.io/myrepo/myapp:latest
       - image-registry.openshift-image-registry.svc:5000
   status:
     internalRegistryHostname: image-registry.openshift-image-registry.svc:5000

   1

   包含用于决定容器运行时在访问构建和 pod 的镜像时应如何处理个别 registry 的配置。它不包含内部集群 registry 的配置。

   2

   指定不安全的 registry。您可以在该 registry 中指定存储库。

   3

   确保将任何不安全的 registry 包含在 allowedRegistries 列表中。

   注意

   当定义 allowedRegistries 参数时，除非明确列出，否则所有 registry （包括 registry.redhat.io 和 quay.io registry 和默认的 OpenShift 镜像 registry）都会被阻断。如果使用参数，为了避免 pod 失败，将所有 registry（包括 registry.redhat.io 和 quay.io registry）和 internalRegistryHostname 添加到 allowedRegistries 列表中，因为环境中有效负载镜像需要它们。对于断开连接的集群，还应添加镜像的 registry。

   Machine Config Operator（MCO）会监控 image.config.openshift.io/cluster CR 是否有对 registry 的更改，然后在检测到更改时排空并取消记录节点。节点返回 Ready 状态后，改为在每个节点的 /etc/containers/registries.conf 文件中列出的不安全和受阻 registry。

流程

1. 编辑 image.config.openshift.io/cluster CR:

   $ oc edit image.config.openshift.io/cluster

   以下是 image.config.openshift.io/cluster CR 示例：

   apiVersion: config.openshift.io/v1
   kind: Image
   metadata:
     annotations:
       release.openshift.io/create-only: "true"
     creationTimestamp: "2019-05-17T13:44:26Z"
     generation: 1
     name: cluster
     resourceVersion: "8302"
     selfLink: /apis/config.openshift.io/v1/images/cluster
     uid: e34555da-78a9-11e9-b92b-06d6c7da38dc
   spec:
     allowedRegistriesForImport:
       - domainName: quay.io
         insecure: false
     additionalTrustedCA:
       name: myconfigmap
     registrySources:
       containerRuntimeSearchRegistries: 1
       - reg1.io
       - reg2.io
       - reg3.io
       allowedRegistries: 2
       - example.com
       - quay.io
       - registry.redhat.io
       - reg1.io
       - reg2.io
       - reg3.io
       - image-registry.openshift-image-registry.svc:5000
   ...
   status:
     internalRegistryHostname: image-registry.openshift-image-registry.svc:5000

   1

   指定用于镜像简短名称的 registry。您应该只使用带有内部或私有 registry 的镜像短名称，以减少可能的安全问题。

   2

   确保在 containerRuntimeSearchRegistries 下列出的任何 registry 都包含在 allowedRegistries 列表中。

   注意

   当定义 allowedRegistries 参数时，除非明确列出，否则所有 registry （包括 registry.redhat.io 和 quay.io registry 和默认的 OpenShift 镜像 registry）都会被阻断。如果使用此参数，为了避免 pod 失败，请将所有 registry（包括 registry.redhat.io 和 quay.io registry）和 internalRegistryHostname 添加到 allowedRegistries 列表中，因为环境中有效负载镜像需要它们。对于断开连接的集群，还应添加镜像的 registry。

1. 配置其他CA：

   $ oc create configmap registry-config --from-file=<external_registry_address>=ca.crt -n openshift-config

   $ oc edit image.config.openshift.io cluster

   spec:
     additionalTrustedCA:
       name: registry-config

流程

1. 通过以下方法配置已镜像的存储库：

   • 按照 Red Hat Quay 存储库镜像中所述，使用 Red Hat Quay 来设置已镜像的存储库。使用 Red Hat Quay 有助于您将镜像从一个存储库复制到另一存储库，并可随着时间的推移重复自动同步这些存储库。

   • 使用 skopeo 等工具手动将镜像从源目录复制到已镜像的存储库。

     例如：在 Red Hat Enterprise Linux（RHEL 7 或 RHEL 8）系统上安装 skopeo RPM 软件包后，使用 skopeo 命令，如下例所示：

     $ skopeo copy \
     docker://registry.access.redhat.com/ubi8/ubi-minimal@sha256:5cfbaf45ca96806917830c183e9f37df2e913b187adb32e89fd83fa455ebaa6 \
     docker://example.io/example/ubi-minimal

     在本例中，您有一个名为 example.io 的容器镜像 registry，其中包含一个名为 example 的镜像存储库，您希望将 ubi8/ubi-minimal 镜像从 registry.access.redhat.com 复制到此镜像存储库。创建该 registry 后，您可将 OpenShift Container Platform 集群配置为将源存储库的请求重定向到已镜像的存储库。

2. 登录您的 OpenShift Container Platform 集群。

3. 创建 ImageContentSourcePolicy 文件（如：registryrepomirror.yaml），将源和镜像 (mirror) 替换为您自己的 registry、存储库对和镜像中的源和镜像：

   apiVersion: operator.openshift.io/v1alpha1
   kind: ImageContentSourcePolicy
   metadata:
     name: ubi8repo
   spec:
     repositoryDigestMirrors:
     - mirrors:
       - example.io/example/ubi-minimal 1
       - example.com/example/ubi-minimal 2
       source: registry.access.redhat.com/ubi8/ubi-minimal 3
     - mirrors:
       - mirror.example.com/redhat
       source: registry.redhat.io/openshift4 4
     - mirrors:
       - mirror.example.com
       source: registry.redhat.io 5
     - mirrors:
       - mirror.example.net/image
       source: registry.example.com/example/myimage 6
     - mirrors:
       - mirror.example.net
       source: registry.example.com/example 7
     - mirrors:
       - mirror.example.net/registry-example-com
       source: registry.example.com 8

   1

   指明镜像 registry 和存储库的名称。

   2

   表示每个目标仓库的多个镜像仓库。如果一个镜像停机，则目标仓库可以使用另一个镜像。

   3

   指明包含所镜像内容的 registry 和存储库。

   4

   您可以在 registry 中配置命名空间以使用该命名空间中的任何镜像。如果您使用 registry 域作为源，ImageContentSourcePolicy 资源将应用到 registry 中的所有存储库。

   5

   如果配置 registry 名称，则 ImageContentSourcePolicy 资源将应用到源 registry 中的所有软件仓库。

   6

   拉取镜像 mirror.example.net/image@sha256:…​。

   7

   从 mirror mirror.example.net/myimage@sha256:…​ 的源 registry 命名空间中拉取镜像 myimage。

   8

   从 mirror registry mirror.example.net/registry-example-com/example/myimage@sha256:…​ 拉取镜像 registry.example.com/example/myimage。ImageContentSourcePolicy 资源会应用到源 registry 中的所有仓库到到 mirror registry mirror.example.net/registry-example-com。

4. 创建新的 ImageContentSourcePolicy 对象：

   $ oc create -f registryrepomirror.yaml

   创建 ImageContentSourcePolicy 对象后，新的设置将部署到每个节点，集群开始使用已镜像的存储库来响应源存储库请求。

5. 要检查是否应用了已镜像的配置设置，在其中一个节点上执行以下内容。

   1. 列出您的节点：

      $ oc get node

      输出示例

      NAME                           STATUS                     ROLES    AGE  VERSION
      ip-10-0-137-44.ec2.internal    Ready                      worker   7m   v1.24.0
      ip-10-0-138-148.ec2.internal   Ready                      master   11m  v1.24.0
      ip-10-0-139-122.ec2.internal   Ready                      master   11m  v1.24.0
      ip-10-0-147-35.ec2.internal    Ready                      worker   7m   v1.24.0
      ip-10-0-153-12.ec2.internal    Ready                      worker   7m   v1.24.0
      ip-10-0-154-10.ec2.internal    Ready                      master   11m  v1.24.0

      Imagecontentsourcepolicy 资源不会重启节点。

   2. 启动调试过程以访问节点：

      $ oc debug node/ip-10-0-147-35.ec2.internal

      输出示例

      Starting pod/ip-10-0-147-35ec2internal-debug ...
      To use host binaries, run `chroot /host`

   3. 将您的根目录改为 /host ：

      sh-4.2# chroot /host

   4. 检查 /etc/containers/registries.conf 文件，确保已完成更改：

      sh-4.2# cat /etc/containers/registries.conf

      输出示例

      unqualified-search-registries = ["registry.access.redhat.com", "docker.io"]
      short-name-mode = ""
      
      [[registry]]
        prefix = ""
        location = "registry.access.redhat.com/ubi8/ubi-minimal"
        mirror-by-digest-only = true
      
        [[registry.mirror]]
          location = "example.io/example/ubi-minimal"
      
        [[registry.mirror]]
          location = "example.com/example/ubi-minimal"
      
      [[registry]]
        prefix = ""
        location = "registry.example.com"
        mirror-by-digest-only = true
      
        [[registry.mirror]]
          location = "mirror.example.net/registry-example-com"
      
      [[registry]]
        prefix = ""
        location = "registry.example.com/example"
        mirror-by-digest-only = true
      
        [[registry.mirror]]
          location = "mirror.example.net"
      
      [[registry]]
        prefix = ""
        location = "registry.example.com/example/myimage"
        mirror-by-digest-only = true
      
        [[registry.mirror]]
          location = "mirror.example.net/image"
      
      [[registry]]
        prefix = ""
        location = "registry.redhat.io"
        mirror-by-digest-only = true
      
        [[registry.mirror]]
          location = "mirror.example.com"
      
      [[registry]]
        prefix = ""
        location = "registry.redhat.io/openshift4"
        mirror-by-digest-only = true
      
        [[registry.mirror]]
          location = "mirror.example.com/redhat"

   5. 将镜像摘要从源拉取到节点，并检查是否通过镜像解析。ImageContentSourcePolicy 对象仅支持镜像摘要，不支持镜像标签。

      sh-4.2# podman pull --log-level=debug registry.access.redhat.com/ubi8/ubi-minimal@sha256:5cfbaf45ca96806917830c183e9f37df2e913b187adb32e89fd83fa455ebaa6

流程

1. 您可使用以下命令并指定要用的文件通过 CLI 列出参数：

   $ oc process --parameters -f <filename>

   或者，如果模板已上传：

   $ oc process --parameters -n <project> <template_name>

   例如，下面显示了在默认 openshift 项目中列出其中一个快速启动模板的参数时的输出：

   $ oc process --parameters -n openshift rails-postgresql-example

   输出示例

   NAME                         DESCRIPTION                                                                                              GENERATOR           VALUE
   SOURCE_REPOSITORY_URL        The URL of the repository with your application source code                                                                  https://github.com/sclorg/rails-ex.git
   SOURCE_REPOSITORY_REF        Set this to a branch name, tag or other ref of your repository if you are not using the default branch
   CONTEXT_DIR                  Set this to the relative path to your project if it is not in the root of your repository
   APPLICATION_DOMAIN           The exposed hostname that will route to the Rails service                                                                    rails-postgresql-example.openshiftapps.com
   GITHUB_WEBHOOK_SECRET        A secret string used to configure the GitHub webhook                                                     expression          [a-zA-Z0-9]{40}
   SECRET_KEY_BASE              Your secret key for verifying the integrity of signed cookies                                            expression          [a-z0-9]{127}
   APPLICATION_USER             The application user that is used within the sample application to authorize access on pages                                 openshift
   APPLICATION_PASSWORD         The application password that is used within the sample application to authorize access on pages                             secret
   DATABASE_SERVICE_NAME        Database service name                                                                                                        postgresql
   POSTGRESQL_USER              database username                                                                                        expression          user[A-Z0-9]{3}
   POSTGRESQL_PASSWORD          database password                                                                                        expression          [a-zA-Z0-9]{8}
   POSTGRESQL_DATABASE          database name                                                                                                                root
   POSTGRESQL_MAX_CONNECTIONS   database max connections                                                                                                     10
   POSTGRESQL_SHARED_BUFFERS    database shared buffers                                                                                                      12MB

   该输出标识了在处理模板时使用类似正则表达式的生成器生成的几个参数。

流程

1. 处理定义模板的文件进以将对象列表返回到标准输出：

   $ oc process -f <filename>

   或者，如果模板已上传到当前项目：

   $ oc process <template_name>

2. 通过处理模板并将输出传送至 oc create 来从模板创建对象：

   $ oc process -f <filename> | oc create -f -

   或者，如果模板已上传到当前项目：

   $ oc process <template> | oc create -f -

3. 您可以为每个要覆盖的 <name>=<value> 对添加 -p 选项，以覆盖文件中定义的任何参数值。参数引用可能会出现在模板项目内的任何文本字段中。

   例如，在以下部分中，模板的 POSTGRESQL_USER 和 POSTGRESQL_DATABASE 参数被覆盖，以输出带有自定义环境变量的配置：

   1. 从模板创建对象列表

      $ oc process -f my-rails-postgresql \
          -p POSTGRESQL_USER=bob \
          -p POSTGRESQL_DATABASE=mydatabase

   2. JSON 文件可重定向到文件，也可直接应用，而无需通过将已处理的输出传送到 oc create 命令来上传模板：

      $ oc process -f my-rails-postgresql \
          -p POSTGRESQL_USER=bob \
          -p POSTGRESQL_DATABASE=mydatabase \
          | oc create -f -

   3. 如有大量参数，可将其保存到文件中，然后将此文件传递到 oc process：

      $ cat postgres.env
      POSTGRESQL_USER=bob
      POSTGRESQL_DATABASE=mydatabase

      $ oc process -f my-rails-postgresql --param-file=postgres.env

   4. 此外，您还可使用 "-" 作为 --param-file 的参数，从标准输入中读取环境：

      $ sed s/bob/alice/ postgres.env | oc process -f my-rails-postgresql --param-file=-

流程

1. 运行 Rails 生成器：

   $ rails generate controller welcome index

   已创建所有必要文件。

2. 按如下方式编辑 config/routes.rb 文件中第 2 行：

   root 'welcome#index'

3. 运行 rails 服务器以验证页面是否可用：

   $ rails server

   在浏览器中访问 http://localhost:3000 即可查看您的页面。如果没有看到该页面，请检查输出至服务器的日志进行调试。

流程

1. 运行 ls -1 命令，确保已在 Rails 应用程序目录中。命令输出应类似于：

   $ ls -1

   输出示例

   app
   bin
   config
   config.ru
   db
   Gemfile
   Gemfile.lock
   lib
   log
   public
   Rakefile
   README.rdoc
   test
   tmp
   vendor

2. 在 Rails 应用程序目录中运行以下命令，以便初始化代码并将其提交给 git：

   $ git init

   $ git add .

   $ git commit -m "initial commit"

   提交应用程序后，必须将其推送（push）到远程存储库。Github 帐户，您可使用它创建新的存储库。

3. 设置指向 git 存储库的远程存储库：

   $ git remote add origin git@github.com:<namespace/repository-name>.git

4. 将应用程序推送（push）到远程 git 存储库。

   $ git push

流程

1. 创建数据库服务：

   $ oc new-app postgresql -e POSTGRESQL_DATABASE=db_name -e POSTGRESQL_USER=username -e POSTGRESQL_PASSWORD=password

   若也要为数据库管理员设置密码，请将以下内容附加至上一命令中：

   -e POSTGRESQL_ADMIN_PASSWORD=admin_pw

2. 监控进度：

   $ oc get pods --watch

流程

1. 创建前端服务，并指定创建数据库服务时设置的数据库相关环境变量：

   $ oc new-app path/to/source/code --name=rails-app -e POSTGRESQL_USER=username -e POSTGRESQL_PASSWORD=password -e POSTGRESQL_DATABASE=db_name -e DATABASE_SERVICE_NAME=postgresql

   通过此命令，OpenShift Container Platform 可获取源代码，设置构建程序来构建应用程序镜像，并与指定的环境变量一同来部署新创建的镜像。该应用程序命名为 rails-app。

2. 通过查看 rails-app 部署配置的 JSON 文档来验证环境变量是否已添加：

   $ oc get dc rails-app -o json

   您应看到以下部分：

   输出示例

   env": [
       {
           "name": "POSTGRESQL_USER",
           "value": "username"
       },
       {
           "name": "POSTGRESQL_PASSWORD",
           "value": "password"
       },
       {
           "name": "POSTGRESQL_DATABASE",
           "value": "db_name"
       },
       {
           "name": "DATABASE_SERVICE_NAME",
           "value": "postgresql"
       }
   
   ],

3. 检查构建流程：

   $ oc logs -f build/rails-app-1

4. 构建完成后，查看 OpenShift Container Platform 中运行的 pod：

   $ oc get pods

   您应看到其中一行命令以 myapp-<number>-<hash> 开头，这是您在 OpenShift Container Platform 中运行的应用程序。

5. 在应用程序正常工作前，您必须运行数据库迁移脚本来初始化数据库。具体可通过两种方式实现：

   • 从正在运行的前端容器手动实现：

     • 使用 rsh 命令执行到前端容器中：

       $ oc rsh <frontend_pod_id>

     • 从容器内部运行迁移：

       $ RAILS_ENV=production bundle exec rake db:migrate

       如果在 development 或 test 环境中运行 Rails 应用程序，则不必指定 RAILS_ENV 环境变量。

   • 通过在模板中添加部署前生命周期 hook。

1. 运行 FROM <builder image> 命令
2. 将源代码复制到构建器镜像中定义的位置
3. 在构建器镜像中运行 assemble 脚本
4. 将构建器镜像中的 run 脚本设置为默认命令

流程

1. 查看 io.openshift.s2i.scripts-url 标签的值，以确定构建器镜像中的脚本位置：

   $ podman inspect --format='{{ index .Config.Labels "io.openshift.s2i.scripts-url" }}' wildfly/wildfly-centos7

   输出示例

   image:///usr/libexec/s2i

   您检查了 wildfly/wildfly-centos7 构建器镜像，并发现脚本位于 /usr/libexec/s2i 目录中。

2. 创建一个包含其它命令中嵌套的标准脚本之一的脚本：

   .s2i/bin/assemble 脚本

   #!/bin/bash
   echo "Before assembling"
   
   /usr/libexec/s2i/assemble
   rc=$?
   
   if [ $rc -eq 0 ]; then
       echo "After successful assembling"
   else
       echo "After failed assembling"
   fi
   
   exit $rc

   这个示例显示了一个自定义 assemble 脚本，它输出信息，从镜像中运行标准 assemble 脚本，并根据 assemble 脚本的退出代码输出另一个信息。

   重要

   当嵌套 run 脚本时，您必须使用 exec 来调用它来确保正确处理信号。使用 exec 也无法在调用默认镜像运行脚本后运行附加命令。

   .s2i/bin/run 脚本

   #!/bin/bash
   echo "Before running application"
   exec /usr/libexec/s2i/run