如何在 Azure Service Fabric 中为 docker 容器指定命令行参数

Question

我有一个 docker 映像 wiremock.net-nano，它接受额外的命令行参数，例如 --Port 和 --AdminUsername。

正常的 docker 命令行如下所示：

docker run --rm -p 9091:80 sheyenrath/wiremock.net-nano --ReadStaticMappings true --AdminUsername x --AdminPassword y --RequestLogExpirationDuration 24

但是如何在 Azure Service Fabric 中配置这些参数？
ServiceManifest.xml 文件仅定义图像名称 (<ImageName>sheyenrath/wiremock.net-nano</ImageName>) 和端口转发 (<Endpoint Name="WireMock_ContainerTypeEndpoint" Port="9091" />)。

Answer 1

如果我没记错的话，元素中的 <ContainerHostEntryPointType>/<Commands> 就是您要查找的内容。

根据ServiceManifest.xmlschema：

将逗号分隔的命令列表传递给容器。

架构摘录：

<xs:complexType xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ContainerHostEntryPointType">
<xs:sequence>
  <!--container image name-->
  <xs:element name="ImageName" type="xs:string">
    <xs:annotation>
      <xs:documentation>The repo and image on https://hub.docker.com or Azure Container Registry.</xs:documentation>
    </xs:annotation>
  </xs:element>
  <!--comma delimited list of commands for container-->
  <xs:element name="Commands" type="xs:string" minOccurs="0" maxOccurs="1">
    <xs:annotation>
      <xs:documentation>Pass a comma delimited list of commands to the container.</xs:documentation>
    </xs:annotation>
  </xs:element>
  <xs:element name="EntryPoint" type="xs:string" minOccurs="0" maxOccurs="1"/>
  <xs:element name="FromSource" type="xs:string" minOccurs="0" maxOccurs="1"/>
</xs:sequence>

Answer 2

正如 Oleg 正确解释的那样，您必须在 <Commands> 元素中的容器映像名称旁边指定 ServiceManifest.xml 中的参数。

给我带来麻烦的是正确传递带有值的参数。我发现如果存在空格，Service Fabric 会将您的命令包含在双引号中。在这种情况下，您必须用逗号替换空格。

例如，我有一个自定义 Dockerfile，它具有以下 exec 格式的入口点定义：

ENTRYPOINT ["redis-server.exe", "C:\\Redis\\redis.docker.conf"]

我想将 --slaveof my-redis-master-instance 6379 作为参数传递给我的 docker 容器（其中 6379 是主容器的端口）。以下服务清单会导致错误：

<EntryPoint>
  <ContainerHost>
    <ImageName>myrepository.azurecr.io/my.servicefabric.redis:3.</ImageName>
    <Commands>--slaveof my-redis-master-instance 6379</Commands>
  </ContainerHost>
</EntryPoint>

原因是 Service Fabric 确实将命令包装到引号中，然后将其传递给 docker 映像，在该映像中它被解释为单个参数并导致错误。

就像上面已经解释的那样，解决方案是用逗号替换空格。现在 Service Fabric 分别传递参数。

<EntryPoint>
  <ContainerHost>
    <ImageName>myrepository.azurecr.io/my.servicefabric.redis:3.2.100</ImageName>
    <Commands>--slaveof,my-redis-master-instance,6379</Commands>
  </ContainerHost>
</EntryPoint>

为了澄清，在我的例子中，我使用 Service Fabric for Windows 和基于 Nanoserver 1803 的容器。