metadata.go 5.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199
  1. /*
  2. Copyright 2016 The Kubernetes Authors.
  3. Licensed under the Apache License, Version 2.0 (the "License");
  4. you may not use this file except in compliance with the License.
  5. You may obtain a copy of the License at
  6. http://www.apache.org/licenses/LICENSE-2.0
  7. Unless required by applicable law or agreed to in writing, software
  8. distributed under the License is distributed on an "AS IS" BASIS,
  9. WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  10. See the License for the specific language governing permissions and
  11. limitations under the License.
  12. */
  13. package openstack
  14. import (
  15. "encoding/json"
  16. "errors"
  17. "fmt"
  18. "io"
  19. "io/ioutil"
  20. "net/http"
  21. "os"
  22. "path/filepath"
  23. "strings"
  24. "k8s.io/klog"
  25. "k8s.io/kubernetes/pkg/util/mount"
  26. "k8s.io/utils/exec"
  27. )
  28. const (
  29. // metadataURLTemplate allows building an OpenStack Metadata service URL.
  30. // It's a hardcoded IPv4 link-local address as documented in "OpenStack Cloud
  31. // Administrator Guide", chapter Compute - Networking with nova-network.
  32. //https://docs.openstack.org/nova/latest/admin/networking-nova.html#metadata-service
  33. defaultMetadataVersion = "2012-08-10"
  34. metadataURLTemplate = "http://169.254.169.254/openstack/%s/meta_data.json"
  35. // metadataID is used as an identifier on the metadata search order configuration.
  36. metadataID = "metadataService"
  37. // Config drive is defined as an iso9660 or vfat (deprecated) drive
  38. // with the "config-2" label.
  39. //https://docs.openstack.org/nova/latest/user/config-drive.html
  40. configDriveLabel = "config-2"
  41. configDrivePathTemplate = "openstack/%s/meta_data.json"
  42. // configDriveID is used as an identifier on the metadata search order configuration.
  43. configDriveID = "configDrive"
  44. )
  45. // ErrBadMetadata is used to indicate a problem parsing data from metadata server
  46. var ErrBadMetadata = errors.New("invalid OpenStack metadata, got empty uuid")
  47. // DeviceMetadata is a single/simplified data structure for all kinds of device metadata types.
  48. type DeviceMetadata struct {
  49. Type string `json:"type"`
  50. Bus string `json:"bus,omitempty"`
  51. Serial string `json:"serial,omitempty"`
  52. Address string `json:"address,omitempty"`
  53. // .. and other fields.
  54. }
  55. // Metadata has the information fetched from OpenStack metadata service or
  56. // config drives. Assumes the "2012-08-10" meta_data.json format.
  57. // See http://docs.openstack.org/user-guide/cli_config_drive.html
  58. type Metadata struct {
  59. UUID string `json:"uuid"`
  60. Name string `json:"name"`
  61. AvailabilityZone string `json:"availability_zone"`
  62. Devices []DeviceMetadata `json:"devices,omitempty"`
  63. // .. and other fields we don't care about. Expand as necessary.
  64. }
  65. // parseMetadata reads JSON from OpenStack metadata server and parses
  66. // instance ID out of it.
  67. func parseMetadata(r io.Reader) (*Metadata, error) {
  68. var metadata Metadata
  69. json := json.NewDecoder(r)
  70. if err := json.Decode(&metadata); err != nil {
  71. return nil, err
  72. }
  73. if metadata.UUID == "" {
  74. return nil, ErrBadMetadata
  75. }
  76. return &metadata, nil
  77. }
  78. func getMetadataURL(metadataVersion string) string {
  79. return fmt.Sprintf(metadataURLTemplate, metadataVersion)
  80. }
  81. func getConfigDrivePath(metadataVersion string) string {
  82. return fmt.Sprintf(configDrivePathTemplate, metadataVersion)
  83. }
  84. func getMetadataFromConfigDrive(metadataVersion string) (*Metadata, error) {
  85. // Try to read instance UUID from config drive.
  86. dev := "/dev/disk/by-label/" + configDriveLabel
  87. if _, err := os.Stat(dev); os.IsNotExist(err) {
  88. out, err := exec.New().Command(
  89. "blkid", "-l",
  90. "-t", "LABEL="+configDriveLabel,
  91. "-o", "device",
  92. ).CombinedOutput()
  93. if err != nil {
  94. return nil, fmt.Errorf("unable to run blkid: %v", err)
  95. }
  96. dev = strings.TrimSpace(string(out))
  97. }
  98. mntdir, err := ioutil.TempDir("", "configdrive")
  99. if err != nil {
  100. return nil, err
  101. }
  102. defer os.Remove(mntdir)
  103. klog.V(4).Infof("Attempting to mount configdrive %s on %s", dev, mntdir)
  104. mounter := mount.New("" /* default mount path */)
  105. err = mounter.Mount(dev, mntdir, "iso9660", []string{"ro"})
  106. if err != nil {
  107. err = mounter.Mount(dev, mntdir, "vfat", []string{"ro"})
  108. }
  109. if err != nil {
  110. return nil, fmt.Errorf("error mounting configdrive %s: %v", dev, err)
  111. }
  112. defer mounter.Unmount(mntdir)
  113. klog.V(4).Infof("Configdrive mounted on %s", mntdir)
  114. configDrivePath := getConfigDrivePath(metadataVersion)
  115. f, err := os.Open(
  116. filepath.Join(mntdir, configDrivePath))
  117. if err != nil {
  118. return nil, fmt.Errorf("error reading %s on config drive: %v", configDrivePath, err)
  119. }
  120. defer f.Close()
  121. return parseMetadata(f)
  122. }
  123. func getMetadataFromMetadataService(metadataVersion string) (*Metadata, error) {
  124. // Try to get JSON from metadata server.
  125. metadataURL := getMetadataURL(metadataVersion)
  126. klog.V(4).Infof("Attempting to fetch metadata from %s", metadataURL)
  127. resp, err := http.Get(metadataURL)
  128. if err != nil {
  129. return nil, fmt.Errorf("error fetching %s: %v", metadataURL, err)
  130. }
  131. defer resp.Body.Close()
  132. if resp.StatusCode != http.StatusOK {
  133. err = fmt.Errorf("unexpected status code when reading metadata from %s: %s", metadataURL, resp.Status)
  134. return nil, err
  135. }
  136. return parseMetadata(resp.Body)
  137. }
  138. // Metadata is fixed for the current host, so cache the value process-wide
  139. var metadataCache *Metadata
  140. func getMetadata(order string) (*Metadata, error) {
  141. if metadataCache == nil {
  142. var md *Metadata
  143. var err error
  144. elements := strings.Split(order, ",")
  145. for _, id := range elements {
  146. id = strings.TrimSpace(id)
  147. switch id {
  148. case configDriveID:
  149. md, err = getMetadataFromConfigDrive(defaultMetadataVersion)
  150. case metadataID:
  151. md, err = getMetadataFromMetadataService(defaultMetadataVersion)
  152. default:
  153. err = fmt.Errorf("%s is not a valid metadata search order option. Supported options are %s and %s", id, configDriveID, metadataID)
  154. }
  155. if err == nil {
  156. break
  157. }
  158. }
  159. if err != nil {
  160. return nil, err
  161. }
  162. metadataCache = md
  163. }
  164. return metadataCache, nil
  165. }