ETSINFV.KUBERNETES.V 1: Difference between revisions

From NFVwiki
No edit summary
No edit summary
 
(11 intermediate revisions by the same user not shown)
Line 1: Line 1:
<nowiki>Insert non-formatted text here</nowiki>[[https://nfvwiki.etsi.org/index.php?title=VIM_connection_information back to VimConnectionInfo registry]]
[[https://nfvwiki.etsi.org/index.php?title=VIM_connection_information back to VimConnectionInfo registry]]


== '''1 Solution information''' ==
== '''1 Solution information''' ==
{| class="wikitable"
{| class="wikitable"
|'''Solution Name'''
|'''Solution Name [M]'''
|Kubernetes v1
|Kubernetes v1
|-
|-
|'''Description'''
|'''Description [M]'''
|ETSI-registered CISM Connection Info defining the interface and access parameters to use a Kubernetes<sup>®</sup>-based CISM, to be signalled via the APIs specified in ETSI GS NFV-SOL 003.
|ETSI-registered CISM Connection Info defining the interface and access parameters to use a Kubernetes<sup>®</sup>-based CISM, to be signalled via the APIs specified in ETSI GS NFV-SOL 003.
The API of a Kubernetes<sup>®</sup>-based CISM is specified in ETSI GS NFV-SOL 018.
The API of a Kubernetes<sup>®</sup>-based CISM is specified in ETSI GS NFV-SOL 018.
Valid for Kubernetes<sup>®</sup> releases starting from 1.22.
Valid for Kubernetes<sup>®</sup> releases starting from 1.22.
|-
|-
|'''Specification  URI'''
|'''Specification  URI [O]'''
|[https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/003/ https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/018/]
|https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/018/
|}
|}


== '''2 Registration information''' ==
== '''2 Registration information''' ==
{| class="wikitable"
{| class="wikitable"
|'''Registrant name'''
|'''Registrant name [M]'''
|ETSI ISG NFV  
|ETSI ISG NFV  
|}  
|}  
Line 23: Line 23:
== '''3 Requested vimType identifier''' ==
== '''3 Requested vimType identifier''' ==
{| class="wikitable"
{| class="wikitable"
|'''Registrant'''
|'''Registrant [M]'''
|
|
|'''VIM Name'''
|'''VIM Name [M]'''
|
|
|'''Version'''
|'''Version [O]'''
|-
|-
|ETSINFV
|ETSINFV
Line 39: Line 39:
Purpose: Provides information about the interface or interfaces to the CISM, such as the URI of an interface endpoint to communicate with the CISM  
Purpose: Provides information about the interface or interfaces to the CISM, such as the URI of an interface endpoint to communicate with the CISM  
{| class="wikitable"
{| class="wikitable"
|'''interfaceInfo'''
|'''interfaceInfo [M]'''
|-
|-
|<code>{</code>
|
<code>  "$schema": "http://json-schema.org/draft-07/schema#",</code>
<code>{
<code>  "title": "interfaceInfo",</code>
  "$schema": "http://json-schema.org/draft-07/schema#",
<code>  "additionalProperties": false,</code>
  "title": "interfaceInfo",
<code>  "required": [</code>
  "additionalProperties": false,
<code>      "authType", </code>
  "required": [
<code>      "endpoint" </code>
      "authType",
<code>  ],</code>
      "endpoint"
<code>  "type": "object", </code>
  ],
<code>  "properties": { </code>
  "type": "object",
<code>      "authType": { </code>
  "properties": {
<code>        "type": "string", </code>
      "authType": {
<code>        "enum": ["OID", "TOKEN", "CERTIFICATE"], </code>
        "type": "string",
<code>        "description": "The authentication type for the Kubernetes cluster. Indicates the required access information." </code>
        "enum": ["OID", "TOKEN", "CERTIFICATE"],
<code>      }, </code>
        "description": "The authentication type for the Kubernetes cluster. Indicates the required access information."
<code>      "endpoint": { </code>
      },
<code>        "type": "string", </code>
      "endpoint": {
<code>        "format": "url", </code>
        "type": "string",
<code>        "description": "The URL representing the Kubernetes cluster API endpoint." </code>
        "format": "url",
<code>      }, </code>
        "description": "The URL representing the Kubernetes cluster API endpoint."
<code>      "serverCertificate": { </code>
      },
<code>        "type": "string", </code>
      "serverCertificate": {
<code>        "format": "byte", </code>
        "type": "string",
<code>        "description": "CA certificate of the Kubernetes cluster API server in PEM format." </code>
        "format": "byte",
<code>      }, </code>
        "description": "CA certificate of the Kubernetes cluster API server in PEM format."
<code>      "skipCertificateVerification": { </code>
      },
<code>        "default": false, </code>
      "skipCertificateVerification": {
<code>        "type": "boolean", </code>
        "default": false,
<code>        "description": "Certificate verification for the endpoint can be skipped by setting this field to true." </code>
        "type": "boolean",
<code>      } </code>
        "description": "Certificate verification for the endpoint can be skipped by setting this field to true."
<code>  }</code>
      }
<code>}</code>
  }
}
 
|}
|}


== '''5 JSON schema definition of "accessInfo"''' ==
== '''5 JSON schema definition of "accessInfo"''' ==
Purpose: Provides authentication credentials for accessing the VIM, and other access-related information such as tenants or infrastructure resource groups.
Purpose: Provides authentication credentials for accessing the CISM, and other access-related information.
{| class="wikitable"
{| class="wikitable"
|'''accessInfo'''
|'''accessInfo [M]'''
|-
|-
|<code>{</code>
|
<code>  "$schema": "http://json-schema.org/draft-07/schema#",</code>
<code>{
<code>  "title": "accessInfo",</code>
  "$schema": "http://json-schema.org/draft-07/schema#",
<code>  "additionalProperties": false,</code>
  "title": "accessInfo",
<code>  "required": [],</code>
  "additionalProperties": false,
<code>  "type": "object",</code>
  "required": [],
<code>  "properties": {</code>
  "type": "object",
<code>        "tokenAuthInfo": {</code>
  "properties": {
<code>            "type": "object",</code>
        "tokenAuthInfo": {
<code>            "description": "The authentication credentials for token-based authentication."</code>
            "type": "object",
<code>            "properties": {</code>
            "description": "The authentication credentials for token-based authentication."
<code>                "token": { </code>
            "properties": {
<code>                    "type": "string",</code>
                "token": {  
<code>                    "format": "byte",</code>
                    "type": "string",
<code>                    "description": "Binary token to be used for access authentication."</code>
                    "format": "byte",
<code>                }</code>
                    "description": "Binary token to be used for access authentication."
<code>            },</code>
                }
<code>            "required": [</code>
            },
<code>                "token"</code>
            "required": [
<code>            ],</code>
                "token"
<code>        },</code>
            ],
<code>        "certificateAuthInfo": {</code>
        },
<code>            "type": "object",</code>
        "certificateAuthInfo": {
<code>            "description": "The authentication credentials for certificate-based authentication."</code>
            "type": "object",
<code>            "properties": {</code>
            "description": "The authentication credentials for certificate-based authentication."
<code>                "clientCertificate": {</code>
            "properties": {
<code>                    "type": "string",</code>
                "clientCertificate": {
<code>                    "format": "byte",</code>
                    "type": "string",
<code>                    "description": "Kubernetes client certificate data in PEM format."</code>
                    "format": "byte",
<code>                },</code>
                    "description": "Kubernetes client certificate data in PEM format."
<code>                "clientCertificateKey": {</code>
                },
<code>                    "type": "string",</code>
                "clientCertificateKey": {
<code>                    "format": "byte",</code>
                    "type": "string",
<code>                    "description": "Kubernetes client certificate key data in PEM format."</code>
                    "format": "byte",
<code>                }</code>
                    "description": "Kubernetes client certificate key data in PEM format."
<code>            },</code>
                }
<code>            "required": [</code>
            },
<code>                "clientCertificate",</code>
            "required": [
<code>                "clientCertificateKey"</code>
                "clientCertificate",
<code>            ],</code>
                "clientCertificateKey"
<code>        },</code>
            ],
<code>        "oidAuthInfo": {</code>
        },
<code>            "type": "object",</code>
        "oidAuthInfo": {
<code>            "description": "The authentication credentials for Open ID-based authentication."</code>
            "type": "object",
<code>            "properties": {</code>
            "description": "The authentication credentials for Open ID-based authentication."
<code>                "username": {</code>
            "properties": {
<code>                    "type": "string",</code>
                "username": {
<code>                    "description": "The username to use for access."</code>
                    "type": "string",
<code>                },</code>
                    "description": "The username to use for access."
<code>                "password": {</code>
                },
<code>                    "writeOnly": true,</code>
                "password": {
<code>                    "type": "string",</code>
                    "writeOnly": true,
<code>                    "format": "password",</code>
                    "type": "string",
<code>                    "description": "The password for the username for access. Required for input, not returned on output." </code>
                    "format": "password",
<code>                }, </code>
                    "description": "The password for the username for access. Required for input, not returned on output."
<code>                "clientId": { </code>
                },
<code>                    "type": "string", </code>
                "clientId": {
<code>                    "description": "An ID which identifies an client application to use for access." </code>
                    "type": "string",
<code>                }, </code>
                    "description": "An ID which identifies an client application to use for access."
<code>                "clientSecret": { </code>
                },
<code>                    "writeOnly": true, </code>
                "clientSecret": {
<code>                    "type": "string", </code>
                    "writeOnly": true,
<code>                    "format": "password", </code>
                    "type": "string",
<code>                    "description": "The secret for the clientId for access. Required for input, not returned on output." </code>
                    "format": "password",
<code>                }, </code>
                    "description": "The secret for the clientId for access. Required for input, not returned on output."
<code>                "remoteServerCertificate": { </code>
                },
<code>                    "type": "string", </code>
                "remoteServerCertificate": {
<code>                    "format": "byte", </code>
                    "type": "string",
<code>                    "description": "CA certificate data of the Open ID API server in PEM format." </code>
                    "format": "byte",
<code>                }, </code>
                    "description": "CA certificate data of the Open ID API server in PEM format."
<code>                "skipCertificateVerification": { </code>
                },
<code>                    "default": false, </code>
                "skipCertificateVerification": {
<code>                    "type": "boolean", </code>
                    "default": false,
<code>                    "description": "Certificate verification for the remote server can be skipped by setting this field to true." </code>
                    "type": "boolean",
<code>                } </code>
                    "description": "Certificate verification for the remote server can be skipped by setting this field to true."
<code>            }, </code>
                }
<code>            "required": [ </code>
            },
<code>                "username", </code>
            "required": [
<code>                "password", </code>
                "username",
<code>                "clientId" </code>
                "password",
<code>            ], </code>
                "clientId"
<code>        } </code>
            ],
<code>    } </code>
        }
<code>} </code>
    }
}
 
|}
|}


== '''6 JSON schema definition of "extra"''' ==
== '''6 JSON schema definition of "extra"''' ==
Purpose: Provides optional additional VIM type specific information.  
Purpose: Provides optional additional CISM type specific information.  
{| class="wikitable"
{| class="wikitable"
|'''extra'''
|'''extra [O]'''
|-
|-
|<code>not specified</code>
|<code>not specified</code>
|}
|}

Latest revision as of 11:05, 26 April 2022

[back to VimConnectionInfo registry]

1 Solution information

Solution Name [M] Kubernetes v1
Description [M] ETSI-registered CISM Connection Info defining the interface and access parameters to use a Kubernetes®-based CISM, to be signalled via the APIs specified in ETSI GS NFV-SOL 003.

The API of a Kubernetes®-based CISM is specified in ETSI GS NFV-SOL 018. Valid for Kubernetes® releases starting from 1.22.

Specification URI [O] https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/018/

2 Registration information

Registrant name [M] ETSI ISG NFV

3 Requested vimType identifier

Registrant [M] VIM Name [M] Version [O]
ETSINFV . KUBERNETES . V_1

4 JSON schema definition of "interfaceInfo"

Purpose: Provides information about the interface or interfaces to the CISM, such as the URI of an interface endpoint to communicate with the CISM

interfaceInfo [M]

{ 

  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "interfaceInfo",
  "additionalProperties": false,
  "required": [
     "authType",
     "endpoint"
  ],
  "type": "object",
  "properties": {
     "authType": {
        "type": "string",
        "enum": ["OID", "TOKEN", "CERTIFICATE"],
        "description": "The authentication type for the Kubernetes cluster. Indicates the required access information."
     },
     "endpoint": {
        "type": "string",
        "format": "url",
        "description": "The URL representing the Kubernetes cluster API endpoint."
     },
     "serverCertificate": {
        "type": "string",
        "format": "byte",
        "description": "CA certificate of the Kubernetes cluster API server in PEM format."
     },
     "skipCertificateVerification": {
        "default": false,
        "type": "boolean",
        "description": "Certificate verification for the endpoint can be skipped by setting this field to true."
     }
  }

}

5 JSON schema definition of "accessInfo"

Purpose: Provides authentication credentials for accessing the CISM, and other access-related information.

accessInfo [M]

{ 

  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "accessInfo",
  "additionalProperties": false,
  "required": [],
  "type": "object",
  "properties": {
       "tokenAuthInfo": {
           "type": "object",
           "description": "The authentication credentials for token-based authentication."
           "properties": {
               "token": { 
                   "type": "string",
                   "format": "byte",
                   "description": "Binary token to be used for access authentication."
               }
           },
           "required": [
               "token"
           ],
       },
       "certificateAuthInfo": {
           "type": "object",
           "description": "The authentication credentials for certificate-based authentication."
           "properties": {
               "clientCertificate": {
                   "type": "string",
                   "format": "byte",
                   "description": "Kubernetes client certificate data in PEM format."
               },
               "clientCertificateKey": {
                   "type": "string",
                   "format": "byte",
                   "description": "Kubernetes client certificate key data in PEM format."
               }
           },
           "required": [
               "clientCertificate",
               "clientCertificateKey"
           ],
       },
       "oidAuthInfo": {
           "type": "object",
           "description": "The authentication credentials for Open ID-based authentication."
           "properties": {
               "username": {
                   "type": "string",
                   "description": "The username to use for access."
               },
               "password": {
                   "writeOnly": true,
                   "type": "string",
                   "format": "password",
                   "description": "The password for the username for access. Required for input, not returned on output."
               },
               "clientId": {
                   "type": "string",
                   "description": "An ID which identifies an client application to use for access."
               },
               "clientSecret": {
                   "writeOnly": true,
                   "type": "string",
                   "format": "password",
                   "description": "The secret for the clientId for access. Required for input, not returned on output."
               },
               "remoteServerCertificate": {
                   "type": "string",
                   "format": "byte",
                   "description": "CA certificate data of the Open ID API server in PEM format."
               },
               "skipCertificateVerification": {
                   "default": false,
                   "type": "boolean",
                   "description": "Certificate verification for the remote server can be skipped by setting this field to true."
               }
           },
           "required": [
               "username",
               "password",
               "clientId"
           ],
       }
   }

}

6 JSON schema definition of "extra"

Purpose: Provides optional additional CISM type specific information.

extra [O]
not specified
Retrieved from "https://nfvwiki.etsi.org/index.php?title=ETSINFV.KUBERNETES.V_1&oldid=3780"