Questa pagina è stata tradotta dall'API Cloud Translation.

Esegui la migrazione ai container OCI

Questa pagina descrive l'infrastruttura di compilazione richiesta per riprodurre il processo di compilazione di Cloud Foundry durante la generazione di immagini dell'applicazione compatibili con OCI. Se hai già completato la guida alla migrazione di Spring Music puoi seguire questo approfondimento nelle configurazioni di migrazione specifiche per la tua applicazione.

Diagramma che descrive come creare immagini OCI
utilizzando strumenti moderni

Prima di iniziare

Assicurati di aver configurato un nuovo progetto per Cloud Run come descritto nella pagina di configurazione di Cloud Run.
Assicurati di avere un REGISTRY_URI per l'archiviazione dei container. Cloud Run consiglia di utilizzare Artifact Registry. Docker viene utilizzato per creare immagini intermedie per creare il progetto.

Configurazione di un processo di compilazione compatibile con Cloud Foundry

Per supportare questo nuovo processo, devi creare due container OCI di base:

Un'immagine builder che rispecchia il processo di compilazione di Cloud Foundry ed è in grado di creare il codice sorgente dell'applicazione nelle droplet di Cloud Foundry.
Un'immagine di runtime che esegue il mirroring del runtime dell'applicazione Cloud Foundry.

Questa procedura deve essere eseguita almeno una volta dagli amministratori della piattaforma. Una volta stabilito il processo, le immagini di build ed esecuzione possono essere condivise da tutte le applicazioni Cloud Foundry di cui è necessario eseguire la migrazione a Cloud Run.

Crea l'immagine del builder

Questa sezione crea un'immagine build utilizzando cflinux3 come immagine di base. L'immagine di build viene utilizzata come ambiente di build per la creazione dell'immagine dell'applicazione.

Crea una directory denominata build/ e cd al suo interno:
```
mkdir build && cd build
```

Nella cartella build/, crea un nuovo file denominato Dockerfile e incolla il seguente codice:

ARG CF_LINUX_FS=cloudfoundry/cflinuxfs3

FROM golang:1.20-bullseye AS builder_build
WORKDIR /build
RUN ["git", "clone", "--depth=1", "https://github.com/cloudfoundry/buildpackapplifecycle.git"]
WORKDIR /build/buildpackapplifecycle
RUN ["go", "mod", "init", "code.cloudfoundry.org/buildpackapplifecycle"]
RUN ["go", "mod", "tidy"]
RUN CGO_ENABLD=0 go build -o /builder ./builder/

FROM $CF_LINUX_FS
# Set up container tools related to building applications
WORKDIR /lifecycle
COPY --from=builder_build /builder /lifecycle/builder

# Set up environment to match Cloud Foundry's build.
# https://docs.cloudfoundry.org/devguide/deploy-apps/environment-variable.html#app-system-env
WORKDIR /staging/app
WORKDIR /tmp
ENV CF_INSTANCE_ADDR=127.0.0.1:8080 \
CF_INSTANCE_IP=127.0.0.1 \
CF_INSTANCE_INTERNAL_IP=127.0.0.1 \
VCAP_APP_HOST=127.0.0.1 \
CF_INSTANCE_PORT=8080 \
LANG=en_US.UTF-8 \
INSTANCE_GUID=00000000-0000-0000-0000-000000000000 \
VCAP_APPLICATION={} \
VCAP_SERVICES={} \
CF_STACK=cflinuxfs3

Usa Cloud Build per creare e pubblicare l'immagine builder
```
gcloud builds \
    submit --tag "REGISTRY_URI/builder:stable"
```
Sostituisci REGISTRY_URI con l'indirizzo di Artifact Registry in cui vuoi pubblicare l'immagine build. Ad esempio: REGION-docker.pkg.dev/PROJECT_ID/REPOSITORY/builder:stable.

Crea l'immagine di runtime

Questa sezione crea un'immagine di esecuzione utilizzando cflinux3 come immagine di base. L'immagine di esecuzione viene utilizzata come immagine di base quando crei l'immagine finale dell'applicazione.

Crea una directory denominata run/ e cd al suo interno:
```
mkdir run && cd run
```

Nella cartella run/, crea un nuovo script shell denominato entrypoint.bash con il seguente codice:

#!/usr/bin/env bash
set -e

if [[ "$@" == "" ]]; then
exec /lifecycle/launcher "/home/vcap/app" "" ""
else
exec /lifecycle/launcher "/home/vcap/app" "$@" ""
fi

Nella cartella run/, crea un nuovo file denominato Dockerfile e incolla il codice seguente:

ARG CF_LINUX_FS=cloudfoundry/cflinuxfs3

FROM golang:1.20-bullseye AS launcher_build
WORKDIR /build
RUN ["git", "clone", "--depth=1", "https://github.com/cloudfoundry/buildpackapplifecycle.git"]
WORKDIR /build/buildpackapplifecycle
RUN ["go", "mod", "init", "code.cloudfoundry.org/buildpackapplifecycle"]
RUN ["go", "mod", "tidy"]
RUN CGO_ENABLD=0 go build -o /launcher ./launcher/

FROM $CF_LINUX_FS
# Set up container tools related to launching the application
WORKDIR /lifecycle
COPY entrypoint.bash /lifecycle/entrypoint.bash
RUN ["chmod", "+rx", "/lifecycle/entrypoint.bash"]
COPY --from=launcher_build /launcher /lifecycle/launcher

# Set up environment to match Cloud Foundry
WORKDIR /home/vcap
USER vcap:vcap
ENTRYPOINT ["/lifecycle/entrypoint.bash"]

# Expose 8080 to allow app to be run on Cloud Foundry,
# and PORT so the container can be run locally.
# These do nothing on Cloud Run.
EXPOSE 8080/tcp
# Set up environment variables similar to Cloud Foundry.
ENV CF_INSTANCE_ADDR=127.0.0.1:8080 \
CF_INSTANCE_IP=127.0.0.1 \
INSTANCE_IP=127.0.0.1 \
CF_INSTANCE_INTERNAL_IP=127.0.0.1 \
VCAP_APP_HOST=127.0.0.1 \
CF_INSTANCE_PORT=80 \
LANG=en_US.UTF-8 \
CF_INSTANCE_GUID=00000000-0000-0000-0000-000000000000 \
INSTANCE_GUID=00000000-0000-0000-0000-000000000000 \
CF_INSTANCE_INDEX=0 \
INSTANCE_INDEX=0 \
PORT=8080 \
VCAP_APP_PORT=8080 \
VCAP_APPLICATION={} \
VCAP_SERVICES={}

Utilizza Cloud Build per creare e pubblicare l'immagine runtime:
```
gcloud builds submit \
    --tag "REGISTRY_URI/runtime:stable"
```
Sostituisci REGISTRY_URI con l'indirizzo in Artifact Registry in cui vuoi pubblicare l'immagine build. Ad esempio: REGION-docker.pkg.dev/PROJECT_ID/REPOSITORY/runtime:stable.

Creazione di applicazioni Cloud Foundry come immagini OCI

Ogni applicazione di cui viene eseguita la migrazione in Cloud Run ha bisogno di un Dockerfile che corrisponde al modo in cui Cloud Foundry esegue le applicazioni. Il Dockerfile esegue quanto segue:

Carica l'immagine del builder.
Esegue il ciclo di vita del buildpack v2 per creare una droplet.
Estrae il contenuto della goccia.
Carica i contenuti della droplet sull'immagine di esecuzione per creare l'immagine dell'applicazione eseguibile.

L'immagine finale dell'applicazione è compatibile sia con Cloud Foundry che con Cloud Run, quindi puoi eseguire test A/B della migrazione per eseguire il debug di eventuali comportamenti imprevisti.

Questa procedura deve essere eseguita dal team addetto all'applicazione per ogni applicazione da migrare.

Raccogli informazioni sulla build da un'applicazione Cloud Foundry di cui è stato eseguito il deployment

Osserva lo stack di applicazioni. Lo stack viene fornito tramite il flag -s in cf push o nel campo stack del manifest dell'applicazione.
1. Se lo stack è Windows, è probabile che l'applicazione non sia compatibile con Cloud Run. Prima di continuare, devi trasferire l'applicazione su Linux.
2. Se lo stack è vuoto, cflinuxfs3 o cflinuxfs4, è possibile eseguire la migrazione dell'applicazione a Cloud Run.

Raccogli l'elenco dei buildpack dell'applicazione. I buildpack vengono forniti tramite il flag -b in cf push, il campo buildpack nel manifest dell'applicazione o il campo buildpacks del manifest dell'applicazione.

Se non vengono specificati buildpack, significa che sono stati rilevati automaticamente. Consulta l'elenco dei buildpack rilevati nel deployment dell'applicazione più recente in Cloud Foundry oppure specificali esplicitamente se conosci i percorsi.
Se i buildpack sono URL, prendi nota degli URL e vai al passaggio successivo.

Utilizza la seguente tabella per mappare qualsiasi buildpack che utilizza un nome breve agli URL:

Nome breve	URL
`staticfile_buildpack`	https://github.com/cloudfoundry/staticfile-buildpack
`java_buildpack`	https://github.com/cloudfoundry/java-buildpack
`ruby_buildpack`	https://github.com/cloudfoundry/ruby-buildpack
`dotnet_core_buildpack`	https://github.com/cloudfoundry/dotnet-core-buildpack
`nodejs_buildpack`	https://github.com/cloudfoundry/nodejs-buildpack
`go_buildpack`	https://github.com/cloudfoundry/go-buildpack
`python_buildpack`	https://github.com/cloudfoundry/python-buildpack
`php_buildpack`	https://github.com/cloudfoundry/php-buildpack
`binary_buildpack`	https://github.com/cloudfoundry/binary-buildpack
`nginx_buildpack`	https://github.com/cloudfoundry/nginx-buildpack

Il codice sorgente dei buildpack meno comuni è disponibile nell'organizzazione Cloud Foundry GitHub.

Raccogli la posizione del codice sorgente dell'immagine. L'origine viene fornita tramite l'attributo path del manifest dell'applicazione o il flag -p del comando cf push. Se l'origine non è definita, fa riferimento alla directory corrente.
Determina se nella directory del codice sorgente è presente un file .cfignore. Se è presente, spostalo in un file denominato .gcloudignore.

Creare l'applicazione Cloud Foundry

In questo passaggio, organizzi gli elementi della build nella seguente struttura di cartelle:

.
├── cloudbuild.yaml
├── Dockerfile
├── .gcloudignore
└── src
    ├── go.mod
    └── main.go

cloudbuild.yaml fornisce a Cloud Build istruzioni di build specifiche
Dockerfile utilizzerà le immagini di build ed esecuzione dei passaggi precedenti per creare l'immagine dell'applicazione
src/ contiene il codice sorgente della tua applicazione

Crea un file denominato Dockerfile nella directory con il seguente contenuto:

ARG BUILD_IMAGE
ARG RUN_IMAGE
FROM $BUILD_IMAGE as build

COPY src /staging/app
COPY src /tmp/app

ARG BUILDPACKS
RUN /lifecycle/builder \
-buildArtifactsCacheDir=/tmp/cache \
-buildDir=/tmp/app \
-buildpacksDir=/tmp/buildpacks \
-outputBuildArtifactsCache=/tmp/output-cache \
-outputDroplet=/tmp/droplet \
-outputMetadata=/tmp/result.json \
"-buildpackOrder=${BUILDPACKS}" \
"-skipDetect=true"

FROM $RUN_IMAGE
COPY --from=build /tmp/droplet droplet
RUN tar -xzf droplet && rm droplet

Crea un file denominato cloudbuild.yaml nella directory con i seguenti contenuti:

steps:
- name: gcr.io/cloud-builders/docker
  args:
  - 'build'
  - '--network'
  - 'cloudbuild'
  - '--tag'
  - '${_TAG}'
  - '--build-arg'
  - 'BUILD_IMAGE=${_BUILD_IMAGE}'
  - '--build-arg'
  - 'RUN_IMAGE=${_RUN_IMAGE}'
  - '--build-arg'
  - 'BUILDPACKS=${_BUILDPACKS}'
  - '.'
images:
- "${_TAG}"
options:
  # Substitute build environment variables as an array of KEY=VALUE formatted strings here.
  env: []
substitutions:
  _BUILD_IMAGE: BUILD_IMAGE_URI
  _RUN_IMAGE:  RUN_IMAGE_URI
  _BUILDPACKS: BUILDPACK_URL
  _TAG: APP_ARTIFACT_REGISTRY/APP_NAME:latest

Sostituisci BUILD_IMAGE_URI con l'URI dell'immagine build creata nei passaggi precedenti.
Sostituisci RUN_IMAGE_URI con l'URI dell'immagine di esecuzione creata nei passaggi precedenti.
Sostituisci BUILDPACK_URL con gli URL dei buildpack utilizzati dalla tua applicazione. Può essere un elenco separato da virgole con più buildpack.

Se disponi di un file .cfignore, copialo nella directory con il nome .gcloudignore.
Crea una directory denominata src nella directory.
Copia i contenuti della tua applicazione in src:
1. Se l'origine è un file ZIP (inclusi i file .jar), decomprimi i contenuti in src.
2. Se il codice sorgente è una directory, copia il contenuto in src.
Esegui gcloud builds submit . per creare la tua applicazione.

Incompatibilità note

I buildpack che si basano su variabili di ambiente inserite in Cloud Foundry come VCAP_SERVICES non funzioneranno. Dovresti dichiarare esplicitamente una dipendenza da ciò che inseriscono, usando il sistema di gestione del tuo linguaggio.
Per applicare la patch alle immagini prodotte in questo modo, devi ricreare l'immagine utilizzando una versione più recente dell'immagine di build ed esecuzione. Le immagini delle applicazioni non verranno applicate automaticamente tramite l'aggiornamento delle cellule staminali BOSH se le esegui su Cloud Foundry.
Le build avvengono in un ambiente di rete diverso da quello del cluster Cloud Foundry. Potresti dover configurare pool di Cloud Build personalizzati con accesso ai mirror interni dei pacchetti.

Passaggi successivi

Migrazione delle configurazioni delle applicazioni