Migration yatai-deployment from 1.0.x to 1.1.x#

Yatai 1.1.0 adds yatai-image-builder component, docker registry dependency migrated from yatai-deployment to yatai-image-builder

Note

Migrating yatai-deployment to 1.1.0 requires you to have Yatai version 1.0.x.

Breaking Changes#

  • yatai-deployment remove the dependency of docker registry

  • You need to install yatai-image-builder before installing yatai-deployment

Down Time#

Bento deployments will be completely unaffected and remain online.

  • Yatai System

    Yatai system will not go offline

  • BentoDeployment CR

    The BentoDeployment CR will stay online.

Migration steps#

1. Store yatai-deployment helm release values#

helm get values yatai-deployment -n yatai-deployment > /tmp/yatai-deployment-values.yaml

Note

The above command assumes you have installed yatai-deployment with release name yatai-deployment in yatai-deployment namespace. If you have installed yatai-deployment with a different release name or namespace, please adjust the command accordingly.

2. Create yatai-image-builder namespace#

kubectl create namespace yatai-image-builder

3. Install yatai-image-builder-crds#

helm upgrade --install yatai-image-builder-crds yatai-image-builder-crds \
    --repo https://bentoml.github.io/helm-charts \
    -n yatai-image-builder

Warning

If you encounter error like this:

Error: rendered manifests contain a resource that already exists. Unable to continue with install: CustomResourceDefinition "bentorequests.resources.yatai.ai" in namespace "" exists and cannot be imported into the current release: invalid ownership metadata; label validation error: missing key "app.kubernetes.io/managed-by": must be set to "Helm"; annotation validation error: missing key "meta.helm.sh/release-name": must be set to "yatai-image-builder-crds"; annotation validation error: missing key "meta.helm.sh/release-namespace": must be set to "yatai-image-builder"

It means you already have BentoRequest CRD and Bento CRD, you should use this command to fix it:

kubectl label crd bentorequests.resources.yatai.ai app.kubernetes.io/managed-by=Helm
kubectl annotate crd bentorequests.resources.yatai.ai meta.helm.sh/release-name=yatai-image-builder-crds meta.helm.sh/release-namespace=yatai-image-builder
kubectl label crd bentoes.resources.yatai.ai app.kubernetes.io/managed-by=Helm
kubectl annotate crd bentoes.resources.yatai.ai meta.helm.sh/release-name=yatai-image-builder-crds meta.helm.sh/release-namespace=yatai-image-builder

Then reinstall the yatai-image-builder-crds.

4. Verify that the CRDs of yatai-image-builder has been established#

kubectl wait --for condition=established --timeout=120s crd/bentorequests.resources.yatai.ai
kubectl wait --for condition=established --timeout=120s crd/bentoes.resources.yatai.ai

The output of the command above should look something like this:

customresourcedefinition.apiextensions.k8s.io/bentorequests.resources.yatai.ai condition met
customresourcedefinition.apiextensions.k8s.io/bentoes.resources.yatai.ai condition met

5. Install the yatai-image-builder helm chart#

helm upgrade --install yatai-image-builder yatai-image-builder \
    --repo https://bentoml.github.io/helm-charts \
    -n yatai-image-builder \
    --values /tmp/yatai-deployment-values.yaml

6. Verify the yatai-image-builder installation#

kubectl -n yatai-image-builder get pod -l app.kubernetes.io/name=yatai-image-builder

The output should look like this:

Note

Wait until the status of all pods becomes Running or Completed before proceeding.

NAME                                    READY   STATUS      RESTARTS   AGE
yatai-image-builder-8b9fb98d7-xmtd5     1/1     Running     0          67s

View the logs of yatai-image-builder:

kubectl -n yatai-image-builder logs -f deploy/yatai-image-builder

7. Uninstall the old yatai-deployment helm release#

helm -n yatai-deployment uninstall yatai-deployment

Note

The above command assumes you have installed yatai-deployment with release name yatai-deployment in yatai-deployment namespace. If you have installed yatai-deployment with a different release name or namespace, please adjust the command accordingly.

8. Install yatai-deployment-crds#

helm upgrade --install yatai-deployment-crds yatai-deployment-crds \
    --repo https://bentoml.github.io/helm-charts \
    -n yatai-deployment

Warning

If you encounter error like this:

Error: rendered manifests contain a resource that already exists. Unable to continue with install: CustomResourceDefinition "bentodeployments.serving.yatai.ai" in namespace "" exists and cannot be imported into the current release: invalid ownership metadata; label validation error: missing key "app.kubernetes.io/managed-by": must be set to "Helm"; annotation validation error: missing key "meta.helm.sh/release-name": must be set to "yatai-deployment-crds"; annotation validation error: missing key "meta.helm.sh/release-namespace": must be set to "yatai-deployment"

It means you already have BentoDeployment CRD, you should use this command to fix it:

kubectl label crd bentodeployments.serving.yatai.ai app.kubernetes.io/managed-by=Helm
kubectl annotate crd bentodeployments.serving.yatai.ai meta.helm.sh/release-name=yatai-deployment-crds meta.helm.sh/release-namespace=yatai-deployment

Then reinstall the yatai-deployment-crds.

9. Verify that the CRDs of yatai-deployment has been established#

kubectl wait --for condition=established --timeout=120s crd/bentodeployments.serving.yatai.ai

The output of the command above should look something like this:

customresourcedefinition.apiextensions.k8s.io/bentodeployments.serving.yatai.ai condition met

10. Install the yatai-deployment helm chart#

helm upgrade --install yatai-deployment yatai-deployment \
    --repo https://bentoml.github.io/helm-charts \
    -n yatai-deployment \
    --values /tmp/yatai-deployment-values.yaml

11. Verify the yatai-deployment installation#

kubectl -n yatai-deployment get pod -l app.kubernetes.io/name=yatai-deployment

The output should look like this:

Note

Wait until the status of all pods becomes Running or Completed before proceeding.

NAME                                    READY   STATUS      RESTARTS   AGE
yatai-deployment-8b9fb98d7-xmtd5        1/1     Running     0          67s
yatai-deployment-default-domain-s8rh9   0/1     Completed   0          67s

View the logs of yatai-deployment-default-domain:

kubectl -n yatai-deployment logs -f job/yatai-deployment-default-domain

The logs of yatai-deployment-default-domain should be like this:

Note

Automatic domain-suffix generation will take about 1 minute.

time="2022-08-16T14:48:11Z" level=info msg="Creating ingress default-domain- to get a ingress IP automatically"
time="2022-08-16T14:48:11Z" level=info msg="Waiting for ingress default-domain-rrlb9 to be ready"
time="2022-08-16T14:48:41Z" level=info msg="Ingress default-domain-rrlb9 is ready"
time="2022-08-16T14:48:41Z" level=info msg="you have not set the domain-suffix in the network config, so use magic DNS to generate a domain suffix automatically: `10.0.0.116.sslip.io`, and set it to the network config"

View the logs of yatai-deployment:

kubectl -n yatai-deployment logs -f deploy/yatai-deployment