Criação de um componente personalizado para uso no pipeline

Um componente personalizado do ` Orchestration Pipelines ` executa um script criado por você. Você pode usar componentes personalizados para compartilhar scripts reutilizáveis entre pipelines.

Você cria componentes personalizados como ativos do projeto. Você pode então utilizar os componentes em pipelines que você cria nesse projeto. Você pode criar como muitos componentes personalizados para dutos conforme necessário. Atualmente, deve-se criar um componente customizado programaticamente, usando uma função Python .

Como criar um componente como ativo de projeto

Para criar um componente personalizado, use o cliente Python para se autenticar em IBMOrchestration Pipelines, desenvolva o componente e, em seguida, publique-o no projeto especificado. Após estar disponível no projeto, é possível designar o componente a um nó em um pipeline e executá-lo como parte de um fluxo de pipeline.

Este exemplo demonstra o processo de publicação de um componente que inclui dois números juntos e, em seguida, designa o componente a um nó de pipeline

  1. Publicar uma função como um componente com o cliente Python . Execute o código a seguir em um Jupyter Notebook em um projeto.

    # Install libraries
    ! pip install ibm-orchestration-pipelines
    
    # Authentication
    from ibm_orchestration_pipelines import OrchestrationPipelines
    
    apikey = ''
    project_id = 'your_project_id'
    
    client = OrchestrationPipelines(apikey, url=service_url)
    
    
    # Define the function of the component
    
    # If you define the input parameters, users are required to 
    # input them in the UI
    
    def add_two_numbers(a: int, b: int) -> int:
        print('Adding numbers: {} + {}.'.format(a, b))
        return a + b + 10
    
    # Other possible functions might be sending a Slack message,
    # or listing directories in a storage volume, and so on.
    
    # Publish the component    
    client.publish_component(
        name='Add numbers', # Appears in UI as component name 
        func=add_two_numbers,
        description='Custom component adding numbers', # Appears in UI as component description 
        project_id=project_id,
        overwrite=True, # Overwrites an existing component with the same name 
    )
    

    Para gerar uma nova chave de API:

    1. Acesse a página inicial do IBM Cloud
    2. Clique em Gerenciar> Acesso (IAM)
    3. Clique em chaves API
    4. Clique em Criar.
  2. Arraste o nó chamado Componente Executar Pipelines em Executar para a tela
    Recuperando o nó do componente customizado

  3. Escolha o nome do componente que você deseja utilizar
    Escolhendo a função de componente real

  4. Conecte e execute o nó como parte de uma tarefa de pipeline.
    Conectando o componente

Gerenciar componentes de pipeline

Use esses métodos clientes Python para gerenciar componentes de pipeline customizados.

Tabela 1. Gerenciar componentes de pipeline
Método Função
client.get_components(project_id=project_id) Listar componentes de um projeto
client.get_component(project_id=project_id, component_id=component_id) Obter um componente por ID
client.get_component(project_id=project_id, name=component_name) Obter um componente por nome
client.publish_component(component name) Publicar um novo componente
client.delete_component(project_id=project_id, component_id=component_id) Excluir um componente por ID