mirror of
https://github.com/OPCFoundation/UA-.NETStandard.git
synced 2026-10-17 05:11:13 +08:00
e78c648295
# Description
Images CI took 45–100 min per image. The arm64 half of every
`linux/amd64,linux/arm64` build ran `dotnet restore` and `dotnet
publish` in an arm64 SDK container under QEMU. For `refserver`, publish
took 8 min natively for amd64 and 92 min emulated for arm64. On top of
that, every one of the 10 matrix legs recompiled the whole stack.
The output is framework-dependent portable IL, so the compile is now
done once, natively. The image legs only copy files onto the
per-platform runtime base image.
### Dockerfiles (all 10)
- **SDK stage runs on the build platform.** The `build` stage is pinned
to `--platform=$BUILDPLATFORM`. `-p:UseAppHost=false` keeps an x64 app
host out of the arm64 image.
- **New `prebuilt` stage.** It is chosen with a global `ARG
PUBLISH_SOURCE`, which defaults to `build`. Local `docker build` and the
`docker-compose` files are unchanged.
```dockerfile
FROM scratch AS prebuilt
ARG PUBLISH_DIR=artifacts/docker/publish
COPY ${PUBLISH_DIR}/ /app/publish/
FROM ${PUBLISH_SOURCE} AS publish
```
- **Pump: final-stage `RUN`s moved to a native stage.** The `sed` on
`openssl.cnf` and the `mkdir`/`chown`/`chmod` steps now run in a
`$BUILDPLATFORM` `layout` stage. The final stage copies `/layout/` to
`/`, so `/app` and `/diag` keep the `$APP_UID:0` owner and `g=u` mode
they had before. `openssl.cnf` therefore comes from the build-platform
base image. It is a plain config file, so it is expected to match
between architectures.
### `docker-image.yml`
- **Single image list.** The image list lives once, in `env.IMAGES`
(image, project, Dockerfile). `discover` emits it as the matrix.
- **New `publish-samples` job.** It runs `dotnet publish` for each
sample sequentially, so shared libraries compile once. It uses the same
options and NBGV version properties as the Dockerfiles and uploads the
output as the `docker-publish` artifact.
- **`build-and-push-image` legs.** Each leg:
- downloads the artifact;
- builds with `PUBLISH_SOURCE=prebuilt` and
`PUBLISH_DIR=artifacts/docker/publish/<image>`;
- no longer uses `setup-qemu-action`;
- is named `build-and-push-image (<image>)`.
- **`images summary`.** It now also fails when `publish-samples` fails.
### Docs
- `ContainerReferenceServer.md` describes the publish-once / copy-only
flow and the build arguments.
- `DeveloperGuide.md` mentions the `publish-samples` job in the Images
CI section.
Expected: one native publish of about 7 min, then 10 parallel
copy-and-push legs of a few minutes each. Not yet confirmed on CI: the
sandbox could not pull MCR base images, so the prebuilt multi-platform
builds were checked against a Debian-based stand-in base, and the
build-from-source path was not built.
## Related Issues
## Checklist
- [ ] I have signed the
[CLA](https://opcfoundation.org/license/cla/ContributorLicenseAgreementv1.0.pdf)
and read the
[CONTRIBUTING](https://github.com/OPCFoundation/UA-.NETStandard/blob/master/CONTRIBUTING.md)
doc.
- [ ] I have added tests that prove my fix is effective or that my
feature works and increased code coverage.
- [x] I have added all necessary documentation.
- [ ] I have verified that my changes do not introduce (new) build or
analyzer warnings.
- [ ] I ran **all** tests locally using the **UA.slnx** solution against
at least .net **framework** and .net **10**, and all passed.
- [ ] I fixed **all** failing and flaky tests in the CI pipelines and
**all** CodeQL warnings.
- [ ] I have addressed **all** PR feedback received.
---------
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: romanett <7413710+romanett@users.noreply.github.com>
122 lines
4.9 KiB
Docker
122 lines
4.9 KiB
Docker
# PumpDeviceIntegrationServer container image.
|
|
#
|
|
# Multi-stage, framework-dependent build on the .NET AzureLinux 3 base
|
|
# images.
|
|
#
|
|
# IMPORTANT: the build context MUST be the repository ROOT (not this
|
|
# folder), because the project pulls in the whole source tree (src/,
|
|
# src/, tools/). Build it like this:
|
|
#
|
|
# # from the repository root:
|
|
# docker build -f samples/DI/PumpDeviceIntegrationServer/Dockerfile \
|
|
# -t pumpdeviceintegrationserver:local .
|
|
#
|
|
# Running `docker build .` from inside this folder will fail fast with a
|
|
# helpful message (the context would be missing the rest of the repo).
|
|
#
|
|
# The final image runs as a non-root user and listens on 0.0.0.0:62542
|
|
# (override host/port via the `host` / `port` environment variables).
|
|
#
|
|
# Every RUN instruction executes on the build platform ($BUILDPLATFORM): the
|
|
# publish output is portable IL and the final stage only copies files, so a
|
|
# multi-platform build never runs anything under emulation. Images CI
|
|
# publishes every sample once in a native pre-job and selects the "prebuilt"
|
|
# stage instead of compiling here:
|
|
# --build-arg PUBLISH_SOURCE=prebuilt --build-arg PUBLISH_DIR=<folder>
|
|
ARG PUBLISH_SOURCE=build
|
|
|
|
FROM --platform=$BUILDPLATFORM mcr.microsoft.com/dotnet/sdk:10.0-azurelinux3.0 AS build
|
|
WORKDIR /src
|
|
|
|
# JIT is disabled for the source generators unless W^X is turned off on
|
|
# some kernels; match the existing ConsoleReferenceServer Dockerfile.
|
|
ENV DOTNET_EnableWriteXorExecute=0
|
|
|
|
# Copy the full repository. The project pulls in many transitive
|
|
# ProjectReferences, a source-generator analyzer, and AdditionalFiles
|
|
# NodeSet2 XML/CSV inputs, so a per-csproj copy list would be fragile.
|
|
COPY . .
|
|
|
|
# Fail fast with a clear message when the build context is not the
|
|
# repository root (UA.slnx is the root marker).
|
|
RUN test -f UA.slnx || { \
|
|
echo ''; \
|
|
echo 'ERROR: build the repository ROOT as the Docker context, not this folder.'; \
|
|
echo ' The image needs the full source tree (src/, src/, tools/).'; \
|
|
echo ''; \
|
|
echo ' From the repository root run:'; \
|
|
echo ' docker build -f samples/DI/PumpDeviceIntegrationServer/Dockerfile -t pumpdeviceintegrationserver .'; \
|
|
echo ''; \
|
|
exit 1; \
|
|
}
|
|
|
|
ARG Version
|
|
ARG SimpleVersion
|
|
ARG InformationalVersion
|
|
|
|
RUN dotnet restore "samples/DI/PumpDeviceIntegrationServer/PumpDeviceIntegrationServer.csproj" \
|
|
--force
|
|
|
|
RUN dotnet publish "samples/DI/PumpDeviceIntegrationServer/PumpDeviceIntegrationServer.csproj" \
|
|
--no-restore \
|
|
-c Release \
|
|
-f net10.0 \
|
|
-p:PublishAot=false \
|
|
-p:Dockerbuild=true \
|
|
-p:Version=${Version} \
|
|
-p:AssemblyVersion=${SimpleVersion} \
|
|
-p:FileVersion=${Version} \
|
|
-p:InformationalVersion=${InformationalVersion} \
|
|
-p:UseAppHost=false \
|
|
-o /app/publish
|
|
|
|
FROM scratch AS prebuilt
|
|
ARG PUBLISH_DIR=artifacts/docker/publish
|
|
COPY ${PUBLISH_DIR}/ /app/publish/
|
|
|
|
FROM ${PUBLISH_SOURCE} AS publish
|
|
|
|
# Lay out the final file system natively; the final stage below only copies
|
|
# it, which needs no emulation for a foreign target platform.
|
|
FROM --platform=$BUILDPLATFORM mcr.microsoft.com/dotnet/runtime:10.0-azurelinux3.0 AS layout
|
|
|
|
# AzureLinux forces the SymCrypt OpenSSL provider as the default for all
|
|
# EVP operations (default_properties = "?provider=symcryptprovider" in
|
|
# openssl.cnf). SymCrypt's ECDSA SignHash path rejects the self-signing
|
|
# call the OPC UA stack makes when creating its ECC application-instance
|
|
# certificate ("operation not supported for this keytype"). Clearing the
|
|
# forced default lets the standard OpenSSL default provider handle ECDSA
|
|
# (still fully secure; just not the FIPS-validated SymCrypt module).
|
|
#
|
|
# The .NET base images ship a predefined non-root user `app` (UID 1654,
|
|
# exposed via the APP_UID env var). The server creates its
|
|
# certificate/PKI store under /app at runtime. The shared /diag
|
|
# directory carries the diagnostic socket and collected artifacts for
|
|
# the companion Kubernetes diagnostics container.
|
|
COPY --from=publish /app/publish /layout/app/
|
|
RUN mkdir -p /openssl /layout/app/pki /layout/diag \
|
|
&& cp -p /etc/pki/tls/openssl.cnf /openssl/openssl.cnf \
|
|
&& sed -i 's/^default_properties = .*/default_properties = ""/' /openssl/openssl.cnf \
|
|
&& chown -R $APP_UID:0 /layout/app /layout/diag \
|
|
&& chmod -R g=u /layout/app /layout/diag
|
|
|
|
FROM mcr.microsoft.com/dotnet/runtime:10.0-azurelinux3.0-distroless-extra AS final
|
|
COPY --from=layout /openssl/openssl.cnf /etc/pki/tls/openssl.cnf
|
|
# Copy the parent so /app and /diag keep their owner and mode, not only
|
|
# their contents.
|
|
COPY --from=layout /layout/ /
|
|
WORKDIR /app
|
|
ENV HOME=/app \
|
|
DOTNET_DiagnosticPorts=/diag/dotnet-diagnostic.sock,suspend=n,listen
|
|
|
|
USER $APP_UID
|
|
|
|
# Bind to all interfaces so the endpoint is reachable from outside the
|
|
# container. Override with `-e host=...` / `-e port=...`.
|
|
ENV host=0.0.0.0 \
|
|
port=62542
|
|
|
|
EXPOSE 62542
|
|
|
|
ENTRYPOINT ["dotnet", "PumpDeviceIntegrationServer.dll"]
|