Migrating from 0.82

The manifest format changed between wasmCloud 0.82.0 and wasmCloud 1.0.0, and this page aims to guide you through converting your manifest to the latest compatible format. This page assumes that any components you specify in your manifest are built using WIT interfaces.

Component changes

The type field renamed the type from actor to component, and this is a backwards compatible change. Otherwise, there are only additional fields available like id and config.

yaml

components:
  - name: echo
    type: actor
    type: component
    properties:
      image: wasmcloud.azurecr.io/echo:0.3.8
      id: echo
      config: 
        - name: default-language
          properties: 
            lang: en-US

Provider changes

Capability providers no longer need to specify a contract or link_name in order to run in a wadm manifest, and these fields can be removed entirely.

yaml

spec:
  components:
    - name: httpserver
      type: capability
      properties:
        image: wasmcloud.azurecr.io/httpserver:0.19.1
        contract: wasmcloud:httpserver
        link_name: default
      traits:

Link changes

The primary changes to manifests are in links, as links are now unidirectional between a source and target and based entirely on a WIT interface rather than a wasmCloud contract. You will need to examine the way your component uses interfaces in order to migrate to 1.0.

Using the example of the http-keyvalue-counter, let's work through the updates. By inspecting the component, you can determine the direction of each link that the component needs at runtime:

wit

package root:component;

world root {
  import wasi:keyvalue/store@0.2.0-draft;
  import wasi:keyvalue/atomics@0.2.0-draft;
  <!-- omitted wasi:io/cli/clocks/filesystem -->

  export wasi:http/incoming-handler@0.2.0;
}

Each import in a component's WIT will be a link trait associated with that component, and each export will be a link trait associated with a capability provider that targets that component. Once you've rearranged where the link trait is organized in the manifest, you can change the format. Note that the namespace, package, and interfaces fields directly correspond to the WIT import above:

yaml

traits:
- type: linkdef
- type: link
  properties:
    target: redis
    values: 
        URL: redis://127.0.0.1:6379/
    namespace: wasi
    package: keyvalue
    interfaces: [atomics, store] 
    target_config: 
        - name: default-url
          properties: 
            URL: redis://127.0.0.1:6379

All together

Taking each step above together, these are the changes to transform the keyvalue-counter example to match the 1.0 format.

yaml

apiVersion: core.oam.dev/v1beta1
kind: Application
metadata:
  name: kvcounter
  annotations:
    version: v0.0.1
    description: 'wasmCloud Key Value Counter Example'
spec:
  components:
    - name: kvcounter
      type: actor
      type: component
      properties:
        image: wasmcloud.azurecr.io/kvcounter:0.4.2
      traits:
        - type: spreadscaler
          properties:
            instances: 1
        - type: linkdef
        - type: link
            target: redis
            namespace: wasi
            package: keyvalue
            interfaces: [atomics, store] 
            target_config: 
              - name: redis-url
                properties: 
                  url: redis://127.0.0.1:6379
            values: 
              URL: redis://127.0.0.1:6379/
        - type: linkdef
          properties: 
            target: httpserver
            values: 
              ADDRESS: 0.0.0.0:8081

    - name: httpserver
      type: capability
      properties:
        image: wasmcloud.azurecr.io/httpserver:0.17.0
        contract: wasmcloud:httpserver
      traits: 
        - type: link
          properties: 
            target: kvcounter
            namespace: wasi
            package: http
            interfaces: [incoming-handler] 
            source_config: 
              - name: default-http
                properties: 
                  ADDRESS: 0.0.0.0:8081
    - name: redis
      type: capability
      properties:
        image: wasmcloud.azurecr.io/kvredis:0.21.0
        contract: wasmcloud:keyvalue