Propagowanie specyfikacji oprogramowania i rozszerzeń pakietów z projektów do obszarów wdrażania

Aby wyeksportować niestandardowe specyfikacje oprogramowania i rozszerzenia pakietów, które zostały utworzone w projekcie produktu Watson Studio , do miejsca wdrożenia:

1. W interfejsie projektu kliknij kartę Zarządzanie .
2. Wybierz opcję Środowiska.
3. Kliknij kartę Szablony .
4. W menu Opcje środowiska niestandardowego wybierz opcję Awansuj na spację.

Alternatywnie, jeśli promowany jest dowolny model lub funkcja Python powiązana ze środowiskiem niestandardowym z projektu Watson Studio do miejsca wdrożenia, powiązana niestandardowa specyfikacja oprogramowania i rozszerzenie pakietu są również promowane do miejsca wdrażania.

Aby zaktualizować specyfikacje oprogramowania i rozszerzenia pakietów po ich awansowaniu do miejsca wdrażania, wykonaj następujące kroki:

1. W obszarze wdrażania usuń specyfikacje oprogramowania, rozszerzenia pakietów i powiązane modele (opcjonalne), korzystając z klienta Watson Machine Learning Python .
2. W projekcie należy promować model, funkcję lub skrypt, który jest powiązany ze zmienioną niestandardową specyfikacją oprogramowania i rozszerzeniem pakietu na obszar.

Specyfikacje oprogramowania są również uwzględniane podczas importowania projektu lub obszaru, który zawiera jeden z nich.

Zapisywanie pliku conda YAML, który zawiera listę bibliotek innych firm

Aby zapisać plik conda YAML, który zawiera listę bibliotek innych firm jako rozszerzenie pakietu i utworzyć niestandardową specyfikację oprogramowania powiązaną z rozszerzeniem pakietu:

1. Uwierzytelnij i utwórz klienta.

   Patrz sekcja Uwierzytelnianie.

2. Utwórz i ustaw domyślne miejsce wdrożenia, a następnie wyświetl listę dostępnych specyfikacji oprogramowania.

    metadata = {
        wml_client.spaces.ConfigurationMetaNames.NAME:
            'examples-create-software-spec',
        wml_client.spaces.ConfigurationMetaNames.DESCRIPTION:
            'For my models'
    }
    space_details = wml_client.spaces.store(meta_props=metadata)
    space_uid = wml_client.spaces.get_id(space_details)
   
    # set the default space
    wml_client.set.default_space(space_uid)
   
    # see available meta names for software specs
    print('Available software specs configuration:', wml_client.software_specifications.ConfigurationMetaNames.get())
    wml_client.software_specifications.list()
   
    asset_id = 'undefined'
    pe_asset_id = 'undefined'
   

3. Utwórz metadane dla rozszerzeń pakietów, aby dodać je do specyfikacji podstawowej.

   pe_metadata = {
       wml_client.package_extensions.ConfigurationMetaNames.NAME:
           'My custom library',
       # optional:
       # wml_client.software_specifications.ConfigurationMetaNames.DESCRIPTION:
       wml_client.package_extensions.ConfigurationMetaNames.TYPE:
           'conda_yml'
   }
   

4. Utwórz plik yaml, który zawiera listę dodatkowych pakietów, a następnie zapisz go jako customlibrary.yaml.

   Przykładowy plik yaml:

   name: add-regex-package
   dependencies:
       - regex
   

   Informacje na temat poprawnej struktury plików yaml można znaleźć w sekcji Przykłady dostosowań.

5. Zapisz informacje o rozszerzeniu pakietu.

   pe_asset_details = wml_client.package_extensions.store(
       meta_props=pe_metadata,
       file_path='customlibrary.yaml'
   )
   pe_asset_id = wml_client.package_extensions.get_id(pe_asset_details)
   

6. Utwórz metadane dla specyfikacji oprogramowania i zapisz specyfikację oprogramowania.

   # Get the id of the base software specification
   base_id = wml_client.software_specifications.get_id_by_name('default_py3.9')
   
   # create the metadata for software specs
   ss_metadata = {
       wml_client.software_specifications.ConfigurationMetaNames.NAME:
           'Python 3.9 with pre-installed ML package',
       wml_client.software_specifications.ConfigurationMetaNames.DESCRIPTION:
           'Adding some custom libraries like regex', # optional
       wml_client.software_specifications.ConfigurationMetaNames.BASE_SOFTWARE_SPECIFICATION:
           {'guid': base_id},
       wml_client.software_specifications.ConfigurationMetaNames.PACKAGE_EXTENSIONS:
           [{'guid': pe_asset_id}]
   }
   
   # store the software spec
   ss_asset_details = wml_client.software_specifications.store(meta_props=ss_metadata)
   
   # get the id of the new asset
   asset_id = wml_client.software_specifications.get_id(ss_asset_details)
   
   # view new software specification details
   import pprint as pp
   
   ss_asset_details = wml_client.software_specifications.get_details(asset_id)
   print('Package extensions', pp.pformat(
       ss_asset_details['entity']['software_specification']['package_extensions']
   ))
   

Zapisywanie utworzonej przez użytkownika biblioteki Python i tworzenie rozszerzenia pakietu

Informacje na temat wymagań dotyczących obsługi utworzonych przez użytkownika bibliotek Python można znaleźć w sekcji Wymagania dotyczące używania niestandardowych komponentów w modelach.

Aby zapisać utworzony przez użytkownika pakiet Python jako rozszerzenie pakietu i utworzyć niestandardową specyfikację oprogramowania powiązaną z rozszerzeniem pakietu, wykonaj następujące czynności:

1. Uwierzytelnij i utwórz klienta.

   Patrz sekcja Uwierzytelnianie.

2. Utwórz i ustaw domyślne miejsce wdrożenia, a następnie wyświetl listę dostępnych specyfikacji oprogramowania.

    metadata = {
        wml_client.spaces.ConfigurationMetaNames.NAME:
            'examples-create-software-spec',
        wml_client.spaces.ConfigurationMetaNames.DESCRIPTION:
            'For my models'
    }
    space_details = wml_client.spaces.store(meta_props=metadata)
    space_uid = wml_client.spaces.get_id(space_details)
   
    # set the default space
    wml_client.set.default_space(space_uid)
   
    # see available meta names for software specs
    print('Available software specs configuration:', wml_client.software_specifications.ConfigurationMetaNames.get())
    wml_client.software_specifications.list()
   
    asset_id = 'undefined'
    pe_asset_id = 'undefined'
   

3. Utwórz metadane dla rozszerzeń pakietów, aby dodać je do specyfikacji podstawowej.

   Uwaga:

   Jako wartość właściwości metadanych wml_client.package_extensions.ConfigurationMetaNames.TYPE można podać tylko wartość pip_zip .

   pe_metadata = {
       wml_client.package_extensions.ConfigurationMetaNames.NAME:
           'My Python library',
       # optional:
       # wml_client.software_specifications.ConfigurationMetaNames.DESCRIPTION:
       wml_client.package_extensions.ConfigurationMetaNames.TYPE:
           'pip.zip'
   }
   

4. Podaj ścieżkę do biblioteki Python utworzonej przez użytkownika.

   python_lib_file_path="my-python-library-0.1.zip"
   

   Informacje na temat wymagań dotyczących obsługi utworzonych przez użytkownika bibliotek Python można znaleźć w sekcji Wymagania dotyczące używania niestandardowych komponentów w modelach.

5. Zapisz informacje o rozszerzeniu pakietu.

   pe_asset_details = wml_client.package_extensions.store(
       meta_props=pe_metadata,
       file_path=python_lib_file_path
   )
   pe_asset_id = wml_client.package_extensions.get_id(pe_asset_details)
   

6. Utwórz metadane dla specyfikacji oprogramowania i zapisz specyfikację oprogramowania.

   # Get the id of the base software specification
   base_id = wml_client.software_specifications.get_id_by_name('default_py3.9')
   
   # create the metadata for software specs
   ss_metadata = {
       wml_client.software_specifications.ConfigurationMetaNames.NAME:
           'Python 3.9 with pre-installed ML package',
       wml_client.software_specifications.ConfigurationMetaNames.DESCRIPTION:
           'Adding some custom libraries like regex', # optional
       wml_client.software_specifications.ConfigurationMetaNames.BASE_SOFTWARE_SPECIFICATION:
           {'guid': base_id},
       wml_client.software_specifications.ConfigurationMetaNames.PACKAGE_EXTENSIONS:
           [{'guid': pe_asset_id}]
   }
   
   # store the software spec
   ss_asset_details = wml_client.software_specifications.store(meta_props=ss_metadata)
   
   # get the id of the new asset
   asset_id = wml_client.software_specifications.get_id(ss_asset_details)
   
   # view new software specification details
   import pprint as pp
   
   ss_asset_details = wml_client.software_specifications.get_details(asset_id)
   print('Package extensions', pp.pformat(
       ss_asset_details['entity']['software_specification']['package_extensions']
   ))